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File Format Specification 
License Agreement 


MACROMEDIA, INC 

Macromedia* Flash* (SWF) and Flash* Video (FLV) File Format Specification License 
Agreement: 

Please read this document carefully before proceeding. By using this Flash (SWF) and Flash 
Video (FLV) File Format Specification (the "Specification"), you agree to this Macromedia 
Flash (SWF) and Flash Video (FLV) File Format Specification License Agreement (the 
"License"). 

1. Definitions 

a. “Specification" means the file format documentation provided to you pursuant to this 
License to assist you in the creation of media in the Macromedia Flash (SWF) or Flash Video 
(FLV) File Format. 

b. “Products” means your software product(s) and/or service(s) in which you output the Flash 
(SWF) or Flash Video (FLV) File Format through the use of the Specification. 

c. “Flash File Format (SWF)” or “SWF” means the file format designated by .SWF. 

d. “Flash Video Format (FLV)” or “FLV” means the file format designated by .FLV. 

e. “Errors” mean any reproducible quality assurance issue, failure, or malfunction in your 
Products including, but not limited to, the inability to playback sound or display fonts in a 
Macromedia Flash Player and the inability to import successfully into the Macromedia Flash 
authoring software. 

2. Licenses 

Pursuant to the terms and conditions of this License, you are granted a nonexclusive license to 
use the Specification for the sole purposes of developing Products that output SWF or FLV. 
Provided your Product complies with the Specification terms and conditions, then you are 
also granted a nonexclusive license to identify your Product as Macromedia* Flash* Enabled 
according to the Logo Usage Guidelines located at www.macromedia.com/go/ 
flash_trademark. 
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3. Restrictions 

a. You may not use the Specification in any way to create or develop a runtime, client, player, 
executable or other program that reads or renders .swf files. 

b. You may not use the Specification in any way to create a server, executable, or other 
program that will stream or deliver data from a client to a server, from a server to another 
server, or from a server to a client. 

c. You will not make or distribute copies of the Specification, or electronically transfer the 
Specification outside your company. 

d. You agree to identify the SWF or FLV output from within your Product, whether from the 
Save As, Export, or equivalent menus, as “Macromedia Flash (SWF)” or “Macromedia Flash 
Video (FLV)” and to refer to Macromedia Flash according to the Trademark Usage Guidelines 
at www.macromedia.com/go/flash_trademark. 

e. If your Product SWF or FLV export support will be added via a stand-alone plug-in or 
equivalent, you agree to identify the SWF or FLV export feature as ‘[Product] Exporter for 
Macromedia® Flash®’ or ‘[Product] Exporter for Macromedia* Flash® Video’. 

f You agree that your Product must output SWF or FLV files that can play back without 
Errors in the latest versions of the Microsoft Windows, Apple Macintosh, and Linux 
Macromedia Flash Players as listed atwww.macromedia.com/go/flashsource_platforms 
(“Macromedia Supported Platforms”) as may be amended from time to time at Macromedia’s 
sole discretion. 

g. You agree that your Product must output SWF or FLV files that can be opened without 
Errors in the latest version of the Macromedia Flash authoring software listed at 
www.macromedia.com/software/flash/. 

4. Software Defect Reporting 

If you find defects in the Specification, you should report them to 

Flash_Format@macromedia.com. Macromedia will evaluate and, at its sole discretion, may 
address them in a future revision of the Specification. 

5. Updates 

You understand and agree that Macromedia may amend, modify, change, and cease 
distribution or production of the Specification at any time. You understand that this License 
does not entitle you to receive any upgrades, updates, or future versions of the Specification 
under this License. 
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6. Ownership 

Macromedia and its suppliers or licensors shall retain all right, title, and interest to the 
Specification and SWF and FLV. All rights not expressly granted herein are reserved by 
Macromedia. 


7. Indemnity 

You will indemnify and hold Macromedia harmless from any third party claim, loss, or 
damage (including attorney’s fees) related to your use of the Specification or your inclusion of 
SWF or FLV into your Product(s). 

8. Disclaimer of Warranties and Technical Support 

THE SPECIFICATION IS PROVIDED TO YOU FREE OF CHARGE, AND ON AN 
“AS IS” BASIS AND “WITH ALL FAULTS”, WITHOUT ANY TECHNICAL SUPPORT 
OR WARRANTY OF ANY KIND FROM MACROMEDIA. YOU ASSUME ALL RISKS 
THAT THE SPECIFICATION IS SUITABLE OR ACCURATE FOR YOUR NEEDS 
AND YOUR USE OF THE SPECIFICATION IS AT YOUR OWN DISCRETION AND 
RISK. MACROMEDIA DISCLAIMS ALL EXPRESS AND IMPLIED WARRANTIES 
FOR THE SPECIFICATION INCLUDING, WITHOUT LIMITATION, ANY 
WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR 
PURPOSE. ALSO, THERE IS NO WARRANTY OF NON-INFRINGEMENT, TITLE 
OR QUIET ENJOYMENT. 

SOME STATES DO NOT ALLOW THE EXCLUSION OF IMPLIED WARRANTIES, 
SO THE ABOVE EXCLUSION MAY NOT APPLY TO YOU. YOU MAY ALSO HAVE 
OTHER LEGAL RIGHTS THAT VARY FROM STATE TO STATE. THESE 
LIMITATIONS OR EXGLUSIONS OF WARRANTIES AND LIABILITY MAY NOT 
AFFEGT OR PREJUDIGE THE STATUTORY RIGHTS OF A GONSUMER; I.E., A 
PERSON AGQUIRING GOODS OTHERWISE THAN IN THE GOURSE OF A 
BUSINESS. 
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9. Limitation of Damages 

NEITHER MACROMEDIA NOR ITS SUPPLIERS OR LICENSORS SHALL BE 
LIABLE FOR ANY INDIRECT, SPECIAL, INCIDENTAL OR CONSEQUENTIAL 
DAMAGES OR LOSS (INCLUDING DAMAGES FOR LOSS OF BUSINESS, LOSS OF 
PROFITS, OR THE LIKE), ARISING OUT OF THIS LICENSE WHETHER BASED 
ON BREACH OF CONTRACT, TORT (INCLUDING NEGLIGENCE), STRICT 
LIABILITY, PRODUCT LIABILITY OR OTHERWISE, EVEN IF MACROMEDIA OR 
ITS REPRESENTATIVES HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH 
DAMAGES. SOME STATES DO NOT ALLOW THE LIMITATION OR EXGLUSION 
OF LIABILITY FOR INCIDENTAL OR CONSEQUENTIAL DAMAGES, SO THIS 
LIMITATION OR EXCLUSION MAY NOT APPLY TO YOU. 

The limited warranty, exclusive remedies and limited liability set forth above are fundamental 
elements of the basis of the bargain between Macromedia and you. You agree that 
Macromedia would not be able to provide the documentation on an economic basis without 
such limitations. 


10. General 

This License shall be governed by the internal laws of the State of California. This License 
contains the complete agreement between you and Macromedia with respect to the subject 
matter of this License, and supersedes all prior or contemporaneous agreements or 
understandings, whether oral or written. All questions concerning this License shall be 
directed to: Macromedia, Inc., 601 Townsend Street, San Francisco, CA 94103, Attention: 
General Counsel. 
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Introduction 



Macromedia Flash (SWF) 
file format specification 

The Macromedia Flash file format (SWF) (pronounced “swiff”) delivers vector graphics, text, 
video and sound over the Internet to Macromedia Flash Player. The SWF file format is 
designed to be an efficient delivery format, not a format for exchanging graphics between 
graphics editors. It is designed to meet the following goals: 

On-screen display The format is primarily intended for on-screen display and supports 
anti-aliasing, fast rendering to a bitmap of any color format, animation, and interactive 
buttons. 

Extensibility The format is a tagged format, so it can be evolved with new features while 
maintaining backward compatibility with earlier versions of Flash Player. 

Network delivery The format can travel over a network with limited and unpredictable 
bandwidth. The files are compressed to be small and support incremental rendering through 
streaming. The SWF file format is a binary format and is not human readable like HTML. 
The SWF file format uses techniques such as bit-packing and structures with optional fields 
to minimize file size. 

Simplicity The format is simple so that Flash Player is small and easily ported. Also, Flash 
Player depends upon a limited set of operating system features only. 

File independence The files display without dependence on external resources such 
as fonts. 

Scalability The files work well on limited hardware, and can take advantage of better 
hardware when it is available. This ability is important because computers have different 
monitor resolutions and bit depths. 

Speed The files render with quick, high quality. 
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Scriptability The format includes tags that provide sequences of byte codes to be 
interpreted by a stack machine. The byte codes support the ActionScript language. Flash 
Player provides a runtime ActionScript object model that allows interaction with drawing 
primitives, servers, and features of Flash Player. 

SWF files have the extension .swf and a MIME type of application/x-shockwave-flash. 

The SWF format has evolved through several versions. Through SWF 5, substantial additions 
were made to the SWF tag set. Starting with SWF 6 and later, the SWF format changes less, 
as more new Flash features are implemented partly or entirely at the ActionScript level. For 
this reason, anyone planning to generate SWF file content that uses newer features should 
become familiar with the ActionScript object model that Flash Player exposes. The best 
references for this information are Learning ActionScript 2.0 in Flash (see http:// 
livedocs.macromedia.eom/flash/8/main/00001303.html) and Essential ActionScript 2.0 by 
Colin Moock. 

Macromedia seriously considers all feedback to the SWF format specification. In addition, 
any known errors from previously released specifications are corrected in this document. If 
you encounter unclear or potentially erroneous information within the specification, please 
e-mail Macromedia at Flash_Format@macromedia.com, and Macromedia will investigate an 
improvement to the document. 

The SWF header 


All SWF files begin with the following header. The types are defined in Basic Data Types: 


SWF File Header 


Field 

Type 

Comment 

Signature 

UI8 

Signature byte: 

“F” indicates uncompressed 

“C” indicates compressed (SWF 6 and later only) 

Signature 

UI8 

Signature byte always “W” 

Signature 

UI8 

Signature byte always “S” 

Version 

UI8 

Single byte file version (for example, 0x06 for SWF 6) 

FileLength 

UI32 

Length of entire file in bytes 

FrameSize 

RECT 

Frame size in twips 

FrameRate 

UI16 

Frame delay in 8.8 fixed number of frames per second 

FrameCount 

UI16 

Total number of frames in file 
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The header begins with a three-byte signature of either 0x46, 0x57, 0x53 (“FWS”); or 0x43, 
0x57, 0x53 (“CWS”). An FWS signature indicates an uncompressed SWF file; CWS 
indicates that the entire fde after the first 8 bytes (that is, after the FileLength field) was 
compressed by using the ZLIB open standard. The data format that the ZLIB library uses is 
described by Request for Comments (RFCs) documents 1950 to 1952. CWS file compression 
is permitted in SWF 6 or later only. 

A one-byte version number follows the signature. The version number is not an ASCII 
character, but an 8-bit number. For example, for SWF 4, the version byte is 0x04, not the 
ASCII character “4” (0x35). 

The FileLength field is the total length of the SWF file, including the header. If this is an 
uncompressed SWF file (FWS signature), the FileLength field should exactly match the file 
size. If this is a compressed SWF file (CWS signature), the FileLength field indicates the total 
length of the file after decompression, and thus generally does not match the file size. Having 
the uncompressed size available can make the decompression process more efficient. 

The FrameSize field defines the width and height of the on-screen display. This field is stored 
as a RECT structure, meaning that its size may vary according to the number of bits needed 
to encode the coordinates. The FrameSize RECT always has Xmin and Ymin of 0; the Xmax 
and Ymax members define the width and height (see Using bit values) . 

The FrameRate is the desired playback rate in frames per second. This rate is not guaranteed 
if, for example. Flash Player is running on a slow or busy CPU. 

The FrameCount is the total number of frames in this SWF file. 


SWF file structure 


Following the header is a series of tagged data blocks. All tags share a common format, so any 
program parsing a SWF file can skip over blocks it does not understand. Data inside the block 
can point to offsets within the block, but can never point to an offset in another block. This 
ability enables tags to be removed, inserted, or modified by tools that process a SWF file. 

The FileAttributes tag is only required for SWF 8 and later. 


Header 

FileAttributes 

tag 

Tag 

Tag 

Tag 


End tag 


SWF File Structure 


SWF file structure 
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Tag format 

Each tag begins with a tag type and a length. The tag-header formats can be either short or 
long. Short tag headers are used for tags with 62 bytes of data or less. Long tag headers can be 
used for any tag size up to 4 GB, far larger than is presently practical. 

RECORDHEADER (short) 

Field Type Comment 

TagCodeAndLength UI16 Upper 10 bits: tag type 

Lower 6 bits: tag length 


z 

o 

H 

m 


The TagCodeAndLength field is a two-byte word, not a bit field of 10 bits followed by a 
bit field of 6 bits. The little-endian byte ordering of a SWF file makes these two layouts 
different. 


The length specified in the TagCodeAndLength field does not include the 
RECORDHEADER that starts a tag. 

If the tag is 63 bytes or longer, it is stored in a long tag header. The long tag header consists of 
a short tag header with a length of 0x3f, followed by a 32-bit length. 


RECORDHEADER (long) 


Field 

Type 

Comment 

TagCodeAndLength 

UI16 

Tag type and length of 0x3F 

Packed together as in short header 

Length 

SI32 

Length of tag 


Definition and control tags 

The two categories of tags in a SWF file are as follows: 

Definition tags define the content of the SWF file—the shapes, text, bitmaps, sounds, and so 
on. Each definition tag assigns a unique ID called a character ID to the content it defines. 
Flash Player then stores the character in a repository called the dictionary. Definition tags, by 
themselves, do not cause anything to be rendered. 

Controi tags create and manipulate rendered instances of characters in the dictionary, and 
control the flow of the file. 
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Tag ordering in SWF files 

Generally speaking, tags in a SWF can occur in any order. However, you must observe the 
following rules: 

■ The FileAttributes tag must be the first tag in the SWF file for SWF 8 and later. 

■ A tag should only depend on tags that come before it. A tag should never depend on a tag 
that comes later in the file. 

■ A definition tag that defines a character must occur before any control tag that refers to 
that character. 

■ Streaming sound tags must be in order. Out-of-order streaming sound tags result in the 
sound being played out of order. 

■ The End tag is always the last tag in the SWF file. 

The dictionary 

The dictionary is a repository of characters that are defined, and are available for control tags 
to use. The process of building and using the dictionary is as follows: 

1. The definition tag defines some content, such as a shape, font, bitmap, or sound. 

2. The definition tag assigns a unique Characterld to the content. 

3. The content is saved in the dictionary under the Characterld. 

4. A control tag uses the Characterld to retrieve the content from the dictionary, and performs 
some action on the content, such as displaying a shape, or playing a sound. 

Every definition tag must specify a unique ID. Duplicate IDs are not allowed. Typically, the 
first Characterld is 1, the second Characterld is 2, and so on. The number zero (0) is special 
and is considered a null character. 

Control tags are not the only tags that reference the dictionary. Definition tags can use 
characters from the dictionary to define more complex characters. For example, the 
DefmeButton and DefmeSprite tags refer to other characters to define their contents. The 
DefmeText tag can refer to font characters to select different fonts for the text. 
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The following diagram illustrates a typical interaction between definition tags, control tags, 
and the dictionary: 

Tags in SWF file Dictionary 


DefineShape as character 1 


DefineSound as character 2 


DefineFont as character 3 


PlaceObject character 1 
Add shape to display list* 


DefineText as character 4 
Uses font defined as characfer 3 


PlaceObject character 4 
Add text to display list* 


SbowFrame 

Render contents of fhe display* 


DefineMorphShape as character 5 


StartSound character 2 


PlaceObject character 5 
Add Morph to display list* 


SbowFrame 

Render contents of fhe display* 



Character 1 

Shape 



Character 2 

Sound 


Character 3 

Font 


Character 4 


Text 


Characfer 5 

Morpb 


See The Display List. 


Contol tag 
Definition tag 


Processing a SWF file 

Flash Player processes all of the tags in a SWF file until a SbowFrame tag is encountered. At 
this point, the display list is copied to the screen and Flash Player is idle until it is time to 
process the next frame. The contents of the first frame are the cumulative effect of performing 
all of the control tag operations before the first SbowFrame tag. The contents of the second 
frame are the cumulative effect of performing all of the control tag operations from the 
beginning of the file to the second SbowFrame tag, and so on. 
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File compression strategy 

Since SWF files are frequently delivered over a network connection, they should be as 
compact as possible. Several techniques are used to accomplish this, including the following 
items: 

Reuse The structure of the character dictionary makes it easy to reuse elements in a SWF 
file. For example, a shape, button, sound, font, or bitmap can be stored in a file once and 
referenced many times. 

Compression Shapes are compressed by using an efficient delta encoding scheme; often the 
first coordinate of a line is assumed to be the last coordinate of the previous line. Distances are 
also often expressed relative to the last position. 

Default values Some structures, like matrixes and color transforms, have common fields 
that are used more often than others. For example, for a matrix, the most common field is the 
translation field. Scaling and rotation are less common. Therefore, if the scaling field is not 
present, it is assumed to be 100%. If the rotation field is not present, it is assumed that there 
is no rotation. This use of default values helps to minimize file sizes. 

Change Encoding As a rule, SWF files only store the changes between states. This is 
reflected in shape data structures and in the place-move-remove model that the display list 
uses. 

Shape Data Structure The shape data structure uses a unique structure to minimize the 
size of shapes and to render anti-aliased shapes efficiently on the screen. 

Summary 

A SWF file is made up of a header, followed by a number of tags. The two types of tags are 
definition tags and control tags. Definition tags define the objects known as characters, 
which are stored in the dictionary. Control tags manipulate characters, and control the flow 
of the file. 
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CHAPTER 1 


Macromedia Flash (SWF) 
File Format 8 


This chapter describes the new features and tags in the Macromedia Flash SWF 8 file format 
specification. 

Bitmap filters 

SWF 8 introduces expressive graphic effects at runtime without significantly increasing the 
SWF file size. New bitmap filters including blur, drop shadow, glow, bevel, gradient glow, 
gradient bevel, convolution, color matrix, and others can be applied to a display object with 
the use of the PlaceObjectd tag along with the FILTERLIST and FILTER records. 

Blend modes 

Compositing effects are now possible in SWF 8 or later by using blend modes to change the 
way the image of a display object or button combines with the images of objects at lower 
depths. With the PlaceObjectd tag and Button record, blend modes can now be selected as an 
alternative to normal alpha compositing. 

Bitmap caching 

Playback performance can be optimized with bitmap caching. By specifying that a static 
movie clip or button symbol be cached as a bitmap at runtime with the PlaceObjectd tag. 
Flash Player internally caches the display object instead of continually redrawing the image, 
which can provide a significant improvement in playback performance in certain scenarios. 
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Enhanced strokes 

Tags DefineShape4 and DefineMorphShape2, along with the LINESTYLE2 and 
MORP1-ILINESTYLE2 records, build upon previous SWF file capabilities by allowing new 
types of joins and caps as well as the ability to fill a stroke. While earlier line-style records 
permitted only rounded joins and round caps, LINESTYLE2 and MORPFfLINESTYLE2 
also support miter and bevel joins, and square caps and no caps. The new line styles also 
include the option for pixel hinting to correct blurry vertical or horizontal lines. 

Enhanced gradients 

SWF 8 presents increased control over gradients. FILLSTYLE and the new 
FOCALGRADIENT record add a new radial gradient type that permits the focal point to be 
set. In addition, the GRADIENT record can now have up to fifteen control points, up from 
eight in SWF 7 and earlier. 

Advanced text rendering with FlashType 

With the new DefineFontd, DefineFontAlignZones, and CSMTextSettings tags, FlashType 
brings a new anti-aliasing technology to Flash Player. FlashType enables high-quality font 
rendering, especially at small point sizes, while maintaining the aesthetic look and feel of the 
fonts. 

9-slice scaling 

The DefmeScalingGrid tag introduces the concept of 9-slice scaling, which allows 
component-style scaling to be applied to a sprite or button character, better maintaining 
visual integrity. 

On2 Truemotion VP6 

For SWF 6 or later. Flash Player 8 supports the On2 Truemotion VP6 bitstream format, a 
leading-edge video compression algorithm. Additionally, Flash Player 8 adds support for an 
extra alpha channel that is used to simulate transparency in video. 
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Screen Video V2 bitstream codec 

SWF 6 supports Screen Video V2 bitstream format, which is an extension of the Screen video 
bitstream format and is supported in Flash Player 8 and later. Screen Video V2 uses several 
techniques to reduce the amount of data required to represent the on-screen content. 

SWF file attributes and metadata 

Starting with SWF 8, SWF files must always have the new FileAttributes tag as the first tag. 
The FileAttributes tag identifies characteristics of the SWF file itself 

In SWF 8, the FileAttributes tag serves two purposes. The tag identifies whether the SWF file 
contains the Metadata tag, which uses properties such as title and description to describe the 
SWF file to an external process, such as a search engine. In addition, for local playback of a 
SWF file, FileAttributes specifies whether Flash Player should grant the SWF file local or 
network file access. 

FLV data tag format 

The format of FLV Data Tags is specified in the FLV File Format chapter, along with 
descriptions of Audio Tags and Video Tags. 

lmportAssets2 

The ImportAssets2 tag replaces the ImportAssets tag for SWF 8 and later. ImportAssets2 
mirrors the ImportAssets functionality. 
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CHAPTER 2 

Macromedia Flash (SWF) 
File Format 7 


This chapter describes the new features in the Macromedia SWF 7 file format specification. 

ActionScript extensions 

The new ActionScript bytecode ActionDefmeFunction2 expands upon the existing 
ActionDefmeFunction, now allowing a function to store parameters and local variables in 
registers. (The ActionDefmeFunction bytecode is rarely used in SWF 7 and later and was 
superseded by ActionDefmeFunction2 in SWF8.) ActionDefmeFunction2 also provides 
control over the creation and storage of the t h i s , arguments, super, _root, _parent 
and _gl obal common variables. To support these improvements, ActionStoreRegister can 
now access up to 256 registers with the use of bytecode ActionDefmeFunction2. 

To improve the compliance of ActionScript with the ECMA-262 standard, and to provide 
greater support of object-oriented programming, SWF 7 introduces the ActionExtends, 
ActionCastOp, and ActionImplementsOp bytecodes, the only file format changes made to 
support ActionScript 2.0. ActionExtends offers the ability to create a relationship between 
two classes, called the subclass and the superclass. With ActionCastOp, Flash Player 7 or later 
converts an object of one type to another type. ActionImplementsOp specifies the interfaces 
that a class or interface can implement. 

With the SWF 7 format, ActionInstanceOf now reports whether an object implements 
an interface. 

ActionScript now employs exception handling with the ActionTry and ActionThrow 
bytecodes. ActionTry declares handlers for exceptional conditions, and ActionThrow pops an 
error value to be thrown. 
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New video format 

Flash Player 7 supports a simple new lossless video codec called Screen video bitstream 
format, optimized for captures of computer screens in motion. ScreenVideo, like Sorenson 
H.263 Bitstream Format, can appear in both SWF fdes and FLV fdes. 

Flash Player 7 can play back FLV files directly, without the use of the RTMP protocol or Flash 
Communication Server MX. 

Runtime ActionScript controls 

The new ScriptLimits tag provides control over the maximum recursion depth and the 
number of seconds before possible script time out. 

SetTabIndex 

The new SetTabIndex tag sets the index of an object within the Flash Player tab order. 

ClipEventConstruct 

The ClipEventFlags sequence now includes the ClipEventConstruct tag to signal the 
construct event, in addition to the already existing ClipEventInitialize. 

Small text rendering 

Previously, in certain cases, small anti-aliased text would appear blurry in Flash Player. With 
the new flag FontFlagsSmallText in the DefmeFontInfo, DefineFontInfo2, and DeflneFont2 
tags. Flash Player 7 and later aligns character glyphs on pixel boundaries for dynamic and 
input text. 
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CHAPTER 3 


Macromedia Flash (SWF) 
File Format 6 


3 


This chapter describes the new features in the Macromedia SWF 6 file format specification. 

File compression 

SWF 6 or later files can be compressed to reduce their size. A different file-header signature 
(CWS instead of FWS) signals this choice. The compression used is the popular 
ZLIB standard. 

Unicode support 

SWF 6 or later files support Unicode text. 

SWF 6 adds the DefineFontInfo2 tag. This is a minor extension to the DefmeFontInfo tag; 
DefmeFontInfo2 adds a language code field. Similarly, the DefmeFont2 tag uses a previously 
reserved byte to store a language code. Language codes are used for line-breaking 
considerations, and for choosing fallback fonts when a specified device font is unavailable. 
The DefineFontlnfo, DeflneFont2, and DefineFontInfo2 tags have different usage rules in 
SWF 6 or later files. The ANSI and shift-JIS encoding options for character tables are 
deprecated, and all character tables in these tags are encoded by using UCS-2. 

Device font names in SWF 6 or later files are specified by using UTF-8 encoding rather than 
the locale-specific encodings previously used. 

The common STRING type in SWF 6 or later files uses UTF-8 encoding rather than the 
ANSI or shift-JIS encodings previously used. 
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Named anchors 

SWF 6 introduces named anchors, a frame label that allows a frame in a SWF file to be 
seekable, by using a hash (#) symbol in the top-level browser URL, similar to named anchors 
in FITML pages. Named anchors are encoded in SWF 6 or later files by including an extra 
byte after the null terminator of the STRING in the existing FrameLabel tag. 

ActionScript extensions 

For SWF 6 and later files, the DoInitAction contains ActionScript bytecodes just like the 
SWF 3 actions. However, while the actions specified in a DoAction tag are placed on a stack 
and not executed until after all drawing for the frame is complete, the actions in a 
DoInitActions tag are executed as soon as the tag is encountered. The DoInitAction tag is 
used to implement the #initclip pragma in the ActionScript language. This implementation is 
primarily useful for calling registerClass to associate a class definition with a movie clip 
symbol before placing an instance of that symbol on the Stage. 

Button movie clips are a new concept in Flash 6. This means that instances of movie clip 
symbols are allowed to have the same kinds of event handlers as instances of Button symbols, 
in addition to the traditional Movie Clip handlers. Thus, the event-type constants for Button- 
style event handlers can be used in the Clip Actions of a PlaceObject2 tag that targets a movie 
clip symbol in SWF 6 or later files. 

SWF 6 adds the ActionStrictEquals ActionScript bytecode. This addition implements the 
new strict equality operator (===) in the ActionScript language. 

SWF 6 adds ActionCreater and ActionStringCreater ActionScript bytecodes. These bytecodes 
implement the exact opposite of the ActionLess and ActionStringLess bytecodes, which 
eliminates the need to perform greater-than comparisons by doing less-than comparisons 
followed by logical negation. The result is improved performance, and also the eliminating of 
some unintended side effects of changing the order of evaluation in ActionScript. 

SWF 6 adds the ActionInstanceOf ActionScript bytecode, which implements the instanceof 
operator in the ActionScript language. 

SWF 6 adds the ActionEnumerate2 ActionScript bytecode, which works like 
ActionEnumerate, but operates on an object-typed stack argument rather than a variable 
name. 

Starting with SWF 6, the EnableDebugger tag is deprecated in favor of the EnableDebugger2. 
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New audio and video formats 

The existing DefmeSound and SoundStreamBlock tags support a new codec option in SWF 6 
or later files: NellyMoser Asao, optimized for low bitrates (see Nellymoser compression). 

Two tags, DefineVideoStream and VideoFrame, allow video to be embedded in SWF 6 or 
later files. For SWF 6, a single video codec, Sorenson Spark, is available (see Sorenson H.263 
Bitstream Format). 


The FLV file format 

SWF content can perform dynamic two-way audio, video, and data interaction with Flash 
Communication Server MX. In one form of this interaction. Flash Communication Server 
can serve prerecorded or streaming files of the FLV format, which encodes synchronized 
audio, video, and data. The audio and video formats used in FLV are the same as those used 
in SWF. The FLV format, like the SWF format, is an open standard documented by 
Macromedia. 

Improved documentation 

With the release of the SWF 6 specification, the documentation of the following SWF file 
format chapters was extensively revised to improve clarity and detail: 

■ Sounds 

■ Fonts and Text 

■ Bitmaps 

■ Clip actions in PlaceObject2 

■ Button actions in DefineButton2 


Improved documentation 
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CHAPTER 4 


4 


Basic Data Types 


This section describes the basic data types that make up the more complex data structures in 
the Macromedia Flash (SWF) file format. All other structures in the SWF file format are built 
on these fundamental types. 

Coordinates and twips 

The SWF file format stores all x-y coordinates as integers, usually in a unit of measurement 
called a twip. In the SWF format, a rwip is l/20th of a logical pixel. A logical pixel is the same 
as a screen pixel when the file is played at 100%—that is, without scaling. 

For example, a rectangle 800 twips wide by 400 twips high is rendered as 40 by 20 logical 
pixels. Fractional pixel sizes are approximated with anti-aliasing. A rectangle 790 by 390 twips 
(39.5 by 19.5 pixels) appears to have slightly blurred edges. 

Twips are a good compromise between size and precision. They provide sub-pixel accuracy for 
zooming and precise placement of objects, while consuming very few bits per coordinate. 
Coordinates in the SWF file format use the traditional graphics axes: x is horizontal and 
proceeds from minimum values at the left to maximum values at the right, and y is vertical 
and proceeds from minimum values at the top to maximum values at the bottom. 

Integer types and byte order 

The SWF file format uses 8-bit, 16-bit, 32-bit, 64-bit, signed, and unsigned integer types. All 
integer values are stored in the SWF file by using little-endian byte order: the least significant 
byte is stored first, and the most significant byte is stored last, in the same way as the Intel x86 
architecture. The bit order within bytes in the SWF file format is big-endian: the most 
significant bit is stored first, and the least significant bit is stored last. 

For example: 

The 32-bit value 0x456e7120 is stored as 20 71 6e 45. 
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The 16-bit value 0xe712 is stored as 12 e7. 


7\11 integer types must be byte aligned. That is, the first bit of an integer value must be stored 
in the first bit of a byte in the SWF file. 

Signed integers are represented by using traditional 2’s-complement bit patterns. These are the 
signed integer representations used on most modern computer platforms. In the 2’s 
complement system, negative numbers have 1 as the first bit, and zero and positive numbers 
have 0 as the first bit. A negative number, is represented as the bitwise opposite of the 
positive-zero number n- 1. 


Integer Types 
Type 

SIS 

SI16 

SI32 

SI8[n] 

SI16[n] 

UI8 

UI16 

UI32 

UI8[n] 

UI16[n] 

UI24[n] 

UI32[n] 

UI64[n] 


Comment 

Signed 8-bit integer value 
Signed 16-bit integer value 
Signed 32-bit integer value 

Signed 8-bit array-n is the number of array elements 
Signed 16-bit array-n is the is number of array elements 
Unsigned 8-bit integer value 
Unsigned 16-bit integer value 
Unsigned 32-bit integer value 

Unsigned 8-bit array-n is the number of array elements 
Unsigned 16-bit array-n is the number of array elements 
Unsigned 24-bit array-n is the number of array elements 
Unsigned 32-bit array-n is the number of array elements 
Unsigned 64-bit array-n is the number of array elements 


Fixed-point numbers 

The SWF file format supports two types of fixed-point numbers: 32 bit and 16 bit. 

The 32-bit fixed-point numbers are 16.16. That is, the high 16 bits represent the number 
before the decimal point, and the low 16 bits represent the number after the decimal point. 
FIXED values are stored like 32-bit integers in the SWF file (using little-endian byte order) 
and must be byte aligned. 

For example: 

The real value 7.5 is equivalent to: 0x0007.8000 
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This value is stored in the SWF file as: 00 80 07 00 

SWF 8 and later supports 16-bit 8.8 signed, fixed-point numbers. The high 8 bits represent 
the number before the decimal point, and the low 8 bits represent the number after the 
decimal point. FIXED8 values are stored like 16-bit integers in the SWF file (using little- 
endian byte order) and must be byte aligned. 


Fixed-Point Types 

Type 

Comment 

FIXED 

32-bit 16.16 fixed-point number 

FIXED8 

16-bit 8.8 fixed-point number 

Floating-point numbers 

SWF 8 and later supports the use of IEEE Standard 754 compatible floating-point types. 
Three types of floating-point numbers are supported. 

Floating-Point Types 

Type 

Comment 

FLOAT16 

Half-precision (16-bit) floating-point number 

FLOAT 

Single-precision (32-bit) IEEE Standard 754 compatible 

DOUBLE 

Double-precision (64-bit) IEEE Standard 754 
compatible 


FLOAT16 is identical to the characteristics of FLOAT except for changes to the number of 
bits allocated to the exponent and mantissa: 

■ 1 bit for the sign 

■ 5 bits for the exponent, with an exponent bias of 16 

■ 10 bits for the mantissa 

Bit values 

Bit values are variable-length bit fields that can represent three types of numbers: 

1 . Unsigned integers 

2. Signed integers 

3 . Signed 16.16 fixed-point values. 
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Bit values do not have to be byte aligned. Other types (such as UI8 and UI16) are always byte 
aligned. If a byte-aligned type follows a bit value, the last byte that contains the bit value is 
padded with zeros. 

The following example is a stream of 64 bits, made up of 9-bit values of varying length, 
followed by a UI16 value: 


Bytel-Byte2-Byt-e3-Byte4-ByteS-Byte 6 -Byte?-ByteS- 


OlOllOlOlOOlOOlOOlOllllOOlOOOllOlOlllOOllOOl 


□0000100110010101101 


BVl-BV2—BV3 BV4-BVS-BV6BV7—BV8BV9-pad-U16- 


The bit stream begins with a 6-bit value (BVl), followed by a 5-bit value (BV2) that is spread 
across Bytel and Byte2. BV3 is spread across Byte2 and Byte3, while BV4 is wholly contained 
within Byte3. Byte 5 contains two bit values: BV7 and BV8. BV9 is followed by a byte- 
aligned type (UI16), so the last four bits of Byte 6 are padded with zeros. 


Bit Values 

Type Comment 

SB[nBits] Signed-bit value (nBits is the number of bits used to store the value) 

UB[nBlts] UnsIgned-bIt value (nBIts Is the number of bits used to store the value) 

FB[nBits] Signed, fixed-point bit value (nBits Is the number of bits used to store the 

value) 


When an unsigned-bit value is expanded into a larger word size, the leftmost bits are filled 
with zeros. When a signed-bit value is expanded into a larger word size, the high bit is copied 
to the leftmost bits. 

This expansion is called sign extension. For example, the 4-bit unsigned value UB[4] = 1110 
would be expanded to a 16-bit value like this: 0000000000001110 = 14. The same value 
interpreted as a signed value, SB[4] = 1110 would be expanded to 1111111111111110 = -2. 

Signed-bit values are similar but must take account of the sign bit. The signed value of 35 is 
represented asSB[7] = 0100011. The extra zero bit is required; otherwise the high bit is sign 
extended and the value is interpreted as negative. 

Fixed-point bit values are 32-bit 16.16 signed, fixed-point numbers. That is, the high 16 bits 
represent the number before the decimal point, and the low 16 bits represent the number after 
the decimal point. A fixed-point bit value is identical to a signed-bit value, but the 
interpretation is different. For example, a 19-bit, signed-bit value of 0x30000 is interpreted as 
196608 decimal. The 19-bit, fixed-point bit value 0x30000 is interpreted as 3.0. The format 
of this value is effectively 3.16 rather than 16.16. 
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Using bit values 

Bit values are stored by using the minimum number of bits possible for the range needed. 
Most bit value fields use a fixed number of bits. Some use a variable number of bits, but in all 
such cases, the number of bits to be used is explicitly stated in another field in the same 
structure. In these variable-length cases, SWF-file generating applications must determine the 
minimum number of bits necessary to represent the actual values that will be specified. For 
signed-bit values, if the number to be encoded is positive, an extra bit is necessary to preserve 
the leading 0; otherwise sign extension changes the bit value into a negative number. 

As an example of variable-sized bit values, consider the RECT structure: 


RECT 

Field 


Type 

Comment 

Mbits 


UB[5] 

Bits in each rect value field 

Xmin 


SB[Nbits] 

X minimum position for rect 

Xmax 


SB[Nbits] 

X maximum position for rect 

Ymin 


SB[Nbits] 

y minimum position for rect 

Ymax 


SB[Nbits] 

y maximum position for rect 

The Nbits field determines the number of bits used to store 

the coordinate values Xmin, 

Xmax, Ymin, and Ymax. Say the coordinates of the rectangl 

e are as follows: 

Xmin = 127 

decimal 

= 1111111 binary 


Xmax = 260 

decimal 

= 100000100 binary 


Ymin = 15 

decimal 

= 1111b inary 


Ymax = 514 

decimal 

= 1000000010 binary 


Nbits is calculated by finding the coordinate that requires the most bits to represent. In this 

case, that value is 514 

(01000000010 binary) which requires 11 bits to represent. The 

rectangle is stored as the following table shows: 


RECT 




Field 


Type and Value 

Comment 

Nbits 


UB[5] = ioii 

Bits required (11) 

Xmin 


SB[11] = 00001111111 

X minimum in twips (127) 

Xmax 


SB[11] = 00100000100 

X maximum in twips (260) 

Ymin 


SB[11] = 00000001111 

y minimum in twips (15) 

Ymax 


SB[11] = 01000000010 

y maximum in twips (514) 


Bit values 
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String values 


A string value represents a null terminated character string. The format for a string value is a 
sequential list of bytes terminated by the null character byte. 


STRING 



Field 

Type 

Comment 

String 

UI8[zero or more] 

Non-null string character data 

StringEnd 

UI8 

Marks end of string; always 



zero 


In SWF 5 or earlier, STRING values are encoded using either ANSI (which is a superset of 
ASCII) or shift-JIS (a Japanese encoding). You cannot indicate the encoding that is used; 
instead, the decoding choice is made according to the locale in which Flash Player is running. 
This means that text content in SWF 5 or earlier can only be encoded in ANSI or shift-JIS, 
and the target audience must be known during authoring—otherwise garbled text results. 

In SWF 6 or later, STRING values are always encoded by using the Unicode UTF-8 standard. 
This is a multibyte encoding; each character is composed of between one and four bytes. 
UTF-8 is a superset of ASCII; the byte range 0 to 12 7 in UTF-8 exactly matches the ASCII 
mapping, and all ASCII characters 0 to 127 are represented by just one byte. UTF-8 
guarantees that whenever a character other than character 0 (the null character) is encoded by 
using more than one byte, none of those bytes are zero. This avoids the appearance of internal 
null characters in UTF-8 strings, meaning that it remains safe to treat null bytes as string 
terminators, just as for ASCII strings. 


Language code 

A language code identifies a spoken language that applies to text. Language codes are 
associated with font specifications in the SWF file format. 


z 


0 


H 


m 



A language code does not specify a text encoding-, it specifies a spoken language. 


LANGCODE 



Field 

Type 

Comment 

LanguageCode 

UI8 

Language code (see following) 
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Flash Player uses language codes to determine line-breaking rules for dynamic text, and to 
choose backup fonts when a specified device font is unavailable. Other uses for language codes 
may be found in the future. 

A language code of zero means no language. This code results in behavior that is dependent on 
the locale in which Flash Player is running. 

At the time of writing, the following language codes are recognized by Flash Player: 

■ Latin (the western languages covered by Latin-1: English, French, German, and so on) 

■ Japanese 

■ Korean 

■ Simplified Chinese 

■ Traditional Chinese 

RGB color record 


The RGB record represents a color as a 24-bit red, green, and blue value. 


RGB 



Field 

Type 

Comment 

Red 

UI8 

Red color value 

Green 

UI8 

Green color value 

Blue 

UI8 

Blue color value 

RGBA color with alpha record 

The RGBA record represents a color as 32-bit red, green, blue and alpha value. An RGBA 
color with an alpha value of 255 is completely opaque. An RGBA color with an alpha value of 
zero is completely transparent. Alpha values between zero and 255 are partially transparent. 

RGBA 



Field 

Type 

Comment 

Red 

UI8 

Red color value 

Green 

UI8 

Green color value 

Blue 

UI8 

Blue color value 

Alpha 

UI8 

Transparency color value 
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ARGB color with alpha record 

The ARGB record behaves exactly like the RGBA record, but the alpha value for the ARGB 
record is in the first byte. 


ARGB 



Field 

Type 

Comment 

Alpha 

UI8 

Transparency color value 

Red 

UI8 

Red color value 

Green 

UI8 

Green color value 

Blue 

UI8 

Blue color value 

Rectangle record 


A rectangle value represents 
position and a maximum x- 
aligned. 

a rectangular region defined by a minimum x- and j/-coordinate 
and j-coordinate position. The RECT record must be byte 

RECT 



Field 

Type 

Comment 

Mbits 

UB[5] 

Bits used for each subsequent 
field 

Xmln 

SB[Nblts] 

X minimum position for 
rectangle in twips 

Xmax 

SB[Nblts] 

X maximum position for 
rectangle in twips 

Ymln 

SB[Nblts] 

y minimum position for 
rectangle in twips 

Ymax 

SB[Nblts] 

y maximum position for 
rectangle in twips 
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MATRIX record 

The MATRIX record represents a standard 2x3 transformation matrix of the sort commonly 
used in 2D graphics. It is used to describe the scale, rotation, and translation of a graphic 
object. The MATRIX record must be byte aligned. 

MATRIX 


Field 

Type 

Comment 

HasScale 

UB[1] 

Has scale values if equal to 1 

NScaleB1ts 

If HasScale = 1, UB[5] 

Bits In each scale value field 

SealeX 

If HasScale = 1, FB[NScaleBlts] 

X scale value 

SealeY 

If HasScale = 1, FB[NScaleBlts] 

y scale value 

HasRotate 

UB[1] 

Has rotate and skew values If equal 
to 1 

NRotateBits 

If HasRotate = 1, UB[5] 

Bits In each rotate value field 

RotateSkewO 

If HasRotate = 1, 
FBjNRotateBIts] 

First rotate and skew value 

RotateSkewl 

If HasRotate = 1, 
FBjNRotateBIts] 

Second rotate and skew value 

NTranslateBits 

UB[5] 

Bits In each translate value field 

T ranslateX 

SB[NTranslateBlts] 

X translate value in twips 

T ranslateY 

SB[NTranslateBlts] 

y translate value In twips 


The ScaleX, ScaleY, RotateSkewO and RotateSkewl fields are stored as 16.16 fixed-point 
values. The TranslateX and TranslateY values are stored as signed values in twips. 

The MATRIX record is optimized for common cases such as a matrix that performs a 
translation only. In this case, the HasScale and HasRotate flags are zero, and the matrix only 
contains the TranslateX and TranslateY fields. 

The mapping from the MATRIX fields to the 2x3 matrix is as follows: 

ScaleX RotateSkewO 

RotateSkewl ScaleY 

TranslateX TranslateY 

For any coordinates (x, y), the transformed coordinates {x, y') are calculated as follows: 

x' = X * ScaleX + y * RotateSkewl + TranslateX 
y' = X * RotateSkewO + y * ScaleY + TranslateY 


MATRIX record 
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The following table describes how the members of the matrix are used for each type of 
operation: 



ScaleX 

RotateSkewO 

RotateSkewl 

ScaleY 

Rotation 

Cosine 

Sine 

Negative sine 

Cosine 

Scaling 

Horizontal 

scaling 

component 

Nothing 

Nothing 

Vertical scaling 
component 

Shear 

Nothing 

Horizontal 

proportionality 

constant 

Vertical 

proportionality 

constant 

Nothing 

Reflection 

Horizontal 

reflection 

component 

Nothing 

Nothing 

Vertical reflection 
component 


Color transform record 

The CXFORM record defines a simple transform that can be applied to the color space of a 
graphic object. The following are the two types of transform possible: 

■ Multiplication transforms 

■ Addition transforms 

Multiplication transforms multiply the red, green, and blue components by an 8.8 fixed-point 
multiplication term. The fixed-point representation of 1.0 is 0x100 or 256 decimal. 

For any color (R,G,B), the transformed color (R', G', B') is calculated as follows: 

R' = (R * RedMultTerm) / 256 

G' = (G * GreenMultTerm) / 256 

B' = (B * BlueMultTerm) / 256 

Addition transforms add an addition term (positive or negative) to the red, green, and blue 
components of the object being displayed. If the result is greater than 255, the result is 
clamped to 255. If the result is less than zero, the result is clamped to zero. 

For any color (R,G,B), the transformed color (R', G', B') is calculated as follows: 

R' = max(0, tninlR + RedAddTerm, 255)) 

G' = max(0, tninlG + GreenAddTerm, 255)) 

B' = max(0, tninlB + B1 ueAddTerm, 255)) 
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Addition and multiplication transforms can be combined as follows. The multiplication 
operation is performed first: 


R' 

= max(0, min(((R * 

RedMultTerm) 

/ 

256) 

+ 

RedAddTerm, 

255)) 

G' 

= max(0, min(((G * 

GreenMultTerm) 

/ 

256) 

+ 

GreenAddTerm, 

255)) 

B' 

= max(0, min(((B * 

B1ueMultTerm) 

/ 

256) 

+ 

B1ueAddTerm, 

255)) 


The CXFORM record must be byte aligned. 


CXFORM 



Field 

Type 

Comment 

HasAddTerms 

UB[1] 

Has color addition values if equal to 1 

HasMuItTerms 

UB[1] 

Has color multiply values if equal to 1 

Mbits 

UB[4] 

Bits in each value field 

RedMuItTerm 

If HasMuItTerms = 1, 
SB[Nbits] 

Red multiply value 

GreenMuItTerm 

If HasMuItTerms = 1, 
SB[Nbits] 

Green multiply value 

BlueMuItTerm 

If HasMuItTerms = 1, 
SB[Nbits] 

Blue multiply value 

RedAddTerm 

If HasAddTerms = 1, 
SB[Nbits] 

Red addition value 

GreenAddTerm 

If HasAddTerms = 1, 
SB[Nbits] 

Green addition value 

BlueAddTerm 

If HasAddTerms = 1, 
SB[Nbits] 

Blue addition value 


Color transform with alpha record 

The CXFORMWITHALPHA record extends the functionality of CXFORM by allowing 
color transforms to be applied to the alpha channel, as well as the red, green, and blue 
channels. 

The following are the two types of transform possible: 

■ Multiplication Transforms 

■ Addition Transforms 

Multiplication transforms multiply the red, green, blue, and alpha components by an 
8.8 fixed-point value. The fixed-point representation of 1.0 is 0x100 or 256 decimal. 
Therefore, the result of a multiplication operation should be divided by 256. 
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For any color (R,G,BjA), the transformed color (R', G', B', A') is calculated as follows: 


R' 

= (R 

•k 

RedMultTerm) 

/ 

256 

G' 

= (G 

•k 

GreenMultTerm) 

/ 

256 

B' 

= (B 

•k 

B1ueMultTerm) 

/ 

256 

A' 

= (A 

■k 

A1phaMultTerm) 

/ 

256 


The CXFORMWITHALPHA record is most commonly used to display objects as partially 
transparent, achieved by multiplying the alpha channel by some value between zero and 256. 

Addition transforms add a fixed value (positive or negative) to the red, green, blue, and alpha 
components of the object being displayed. If the result is greater than 255, the result is 
clamped to 255. If the result is less than zero, the result is clamped to zero. 

For any color (R,G,B,A), the transformed color (R', G', B', A') is calculated as follows: 


R' 

= max(0, 

mi n( R 

+ 

RedAddTerm, 

255)) 

G' 

= max(0, 

min(G 

+ 

GreenAddTerm, 

255)) 

B' 

= max(0, 

min(B 

+ 

B1ueAddTerm, 

255)) 

A' 

= max(0, 

mi n(A 

+ 

A1phaAddTerm, 

255)) 


Addition and multiplication transforms can be combined as follows. The multiplication 
operation is performed first: 


R' 

= max(0, 

min( (( R 

■k 

RedMultTerm) 

/ 256) 

+ 

RedAddTerm, 

255)) 

G' 

= max(0, 

mini ((G 

■k 

GreenMultTerm) 

/ 256) 

+ 

GreenAddTerm, 

255)) 

B' 

= max(0, 

mini ((B 

•k 

B1ueMultTerm) 

/ 256) 

+ 

B1ueAddTerm, 

255)) 

A' 

= max(0, 

minl 1 lA 

•k 

A1phaMultTerm) 

/ 256) 

+ 

A1phaAddTerm, 

255)) 


Like the CXFORM record, the GXFORMWITHALPHA record is byte aligned. 


CXFORMWITHALPHA 



Field 

Type 

Comment 

HasAddTerms 

UB[1] 

Has color addition values if 
equal to 1 

HasMuItTerms 

UB[1] 

Has color multiply values if 
equal to 1 

Mbits 

UB[4] 

Bits in each value field 

RedMuItTerm 

If HasMuItTerms = 1, SBjNbits] 

Red multiply value 

GreenMuItTerm 

If HasMuItTerms = 1, SBjNbits] 

Green multiply value 

BlueMuItTerm 

If HasMuItTerms = 1, SBjNbits] 

Blue multiply value 

AlphaMuItTerm 

If HasMuItTerms = 1, SBjNbits] 

Alpha multiply value 

RedAddTerm 

If HasAddTerms = 1, SBjNbits] 

Red addition value 

GreenAddTerm 

If HasAddTerms = 1, SBjNbits] 

Green addition value 
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CXFORMWITHALPHA 



Field 

Type 

Comment 

BlueAddTerm 

If HasAddTerms = 1, SB[Nbits] 

Blue addition value 

AlphaAddTerm 

If HasAddTerms = 1, SB[Nbits] 

Transparency addition value 
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CHAPTER 5 


5 


The Display List 


Displaying a frame of a Macromedia Flash (SWF) file is a three-stage process: 

1 . Objects are defined with definition tags such as DefineShape, DefineSprite and so on. Each 
object is given a unique ID called a character, and stored in a repository called the 
dictionary. 

2. Selected characters are copied from the dictionary and placed on the display list, which is 
the list of the characters that will be displayed in the next frame. 

3 . Once complete, the contents of the display list are rendered to the screen with ShowFrame. 
A depth value is assigned to each character on the display list. The depth determines the 
stacking order of the character. Characters with lower depth values are displayed underneath 
characters with higher depth values. A character with a depth value of 1 is displayed at the 
bottom of the stack. A character can appear more than once in the display list, but at different 
depths. Only one character can be at any given depth. 

In SWF 1 and 2, the display list was a flat list of the objects that are present on the screen at 
any given time. In SWF 3 and later versions, the display list is a hierarchical list where an 
element on the display can have a list of child elements. For more information, see 
DefineSprite. 

The following six tags are used to control the display list: 

■ PlaceObject Adds a character to the display list. 

■ PlaceObject2 & PlaceObject3 Adds a character to the display list, or modifies the 
character at the specified depth. 

■ RemoveObject Removes the specified character from the display list. 

■ RemoveObject2 Removes the character at the specified depth. 

■ ShowFrame Renders the contents of the display list to the display. 

O 
H 

m 


The older tags, PlaceObject and RemoveObject, are rarely used In SWF 3 and 
later versions. 
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The following diagram illustrates the display process. First, three objects are defined: a shape, 
a text object, and a sprite. These objects are given character IDs and stored in the dictionary. 
Character 1 (the shape) is then placed at depth 1, the bottom of the stack, and will be 
obscured by all other characters when the frame is rendered. Character 2 (the text) is placed 
twice; once at depth 2, and once at depth 4, the top of the stack. Character 3 (the sprite) is 
placed at depth 3. 

Definition Dictionary Dispiay List 


DefineShape 
Character ID = 1 


DefineText 
Character ID = 1 


DefineSprite 
Character ID = 1 


Character ID = 

2 

Depth = 4 


Character ID = 

3 

Depth = 3 


Character ID = 

2 

Depth = 2 


Character ID = 

1 

Depth = 1 




Top 


Bottom 


Clipping layers 

Flash supports a special kind of object in the display list called a clipping layer. A character 
placed as a clipping layer is not displayed; rather it clips (or masks) the characters placed above 
it. The ClipDepth field in PlaceObject2 specifies the top-most depth that the clipping layer 
masks. 
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For example, if a shape was placed at depth 1 with a ClipDepth of 4, all depths above 1, up to 
and including depth 4, are masked by the shape placed at depth 1. Characters placed at depths 
above 4 are not masked. 


Top 


Bottom 

Using the display list 

The following procedure creates and displays a Flash animation: 

1 . Define each character with a definition tag. 

Each character is given a unique character ID, and added to the dictionary. 

2. Add each character to the display list with a PlaceObject2 tag. Each PlaceObject2 tag 
specifies the character to be displayed, plus the following attributes: 

A depth value, which controls the stacking order of the character being placed. 
Characters with lower depth values appear to be underneath characters with higher depth 
values. A depth value of 1 means the character is displayed at the bottom of the stack. 
Only one character can be at any given depth. 

A transformation matrix, which determines the position, scale, factor, and angle of 
rotation of the character being placed. The same character can be placed more than once 
(at different depths) with a different transformation matrix. 

An optional color transform, which specifies the color effect applied to the character 
being placed. Color effects include transparency and color shifts. 

An optional name string, which identifies the character being placed for SetTarget 
actions. SetTarget is used to perform actions inside sprite objects. 


Key 


Clipping Layer 


Character masked 
by Clipping Layer 


Character not masked 
by Clipping Layer 


Display List 


Character ID =4 
Depth = 5 


Character ID = 3 
Depth = 4 


Character ID = 3 
Depth = 3 


Character ID = 2 
Depth = 2 


Character ID = 1 
Depth = 1 
ClipDepth = 4 
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An optional ClipDepth value, which specifies the top-most depth that will be masked by 
the character being placed. 

An optional ratio value, which controls how a morph character is displayed when placed. 
A ratio of zero displays the character at the start of the morph. A ratio of 65535 displays 
the character at the end of the morph. 

3. Use a ShowFrame tag to render the contents of the display list to the screen. 

4. Use a PlaceObject2 tag to modify each character on the display List. 

Each PlaceObject2 assigns a new transformation matrix to the character at a given depth. 
The character ID is not specified because each depth can have only one character. 

5. Use a ShowFrame tag to display the characters in their new positions. 

Repeat steps 4 and 5 for each frame of the animation. 

If a character does not change from frame to frame, you do not need to replace the 
unchanged character after each frame. 

6. Use a RemoveObject2 tag to Remove each character from the display list. 

Only the depth value is required to identify the character being removed. 


z 

o 

H 
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Display list tags 

Display list tags are used to add character and character attributes to a display list. 


PlaceObject 

The PlaceObject tag adds a character to the display list. The Characterld identifies the 
character to be added. The Depth field specifies the stacking order of the character. The 
Matrix field species the position, scale, and rotation of the character. If the size of the 
PlaceObject tag exceeds the end of the transformation matrix, it is assumed that a 
ColorTransform field is appended to the record. The ColorTransform field specifies a color 
effect (such as transparency) that is applied to the character. The same character can be added 
more than once to the display list with a different depth and transformation matrix. 


z 


o 


H 


m 



PlaceObject is rarely used in SWF 3 and later versions; it is superseded by PlaceObject2 
and PlaceObject3. 
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The minimum file format version is SWF 1. 


PlaceObject 

Field 

Type 

Comment 

Header 

RECORDHEADER 

Tag type = 4 

Characterld 

UI16 

ID of character to place 

Depth 

UI16 

Depth of character 

Matrix 

MATRIX 

Transform matrix data 

ColorTransform (optional) 

CXFORM 

Color transform data 


PlaceObject2 

The PlaceObject2 tag extends the functionality of the PlaceObject tag. The PlaceObject2 tag 
can both add a character to the display list, and modify the attributes of a character that is 
already on the display list. The PlaceObject2 tag changed slightly from Flash 4 to Flash 5. In 
Flash 5 clip actions were added. 

The tag begins with a group of flags that indicate which fields are present in the tag. The 
optional fields are Characterld, Matrix, ColorTransform, Ratio, ClipDepth, Name, and 
ClipActions. The Depth field is the only field that is always required. 

The depth value determines the stacking order of the character. Characters with lower depth 
values are displayed underneath characters with higher depth values. A depth value of 1 means 
the character is displayed at the bottom of the stack. Any given depth can have only one 
character. This means a character that is already on the display list can be identified by its 
depth alone (that is, a Characterld is not required). 

The PlaceFlagMove and PlaceFlagHasCharacter tags indicate whether a new character is 
being added to the display list, or a character already on the display list is being modified. The 
meaning of the flags is as follows: 

■ PlaceFlagMove = 0 and PIaceFlagHasCharacter = 1 

A new character (with ID of Characterld) is placed on the display list at the specified 
depth. Other fields set the attributes of this new character. 

■ PlaceFlagMove = 1 and PIaceFlagHasCharacter = 0 

The character at the specified depth is modified. Other fields modify the attributes of this 
character. Because any given depth can have only one character, no Characterld is 
required. 
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■ PIaceFlagMove = 1 and PIaceFlagHasCharacter = 1 

The character at the specified Depth is removed, and a new character (with ID of 
Characterld) is placed at that depth. Other fields set the attributes of this new character. 

For example, a character that is moved over a series of frames has PlaceFlagHasCharacter set 

in the first frame, and PlaceFlagMove set in subsequent frames. The first frame places the new 

character at the desired depth, and sets the initial transformation matrix. Subsequent frames 

replace the transformation matrix of the character at the desired depth. 

The optional fields in PlaceObject2 have the following meaning: 

■ The Characterld field specifies the character to be added to the display list. Characterld is 
used only when a new character is being added. If a character that is already on the display 
list is being modified, the Characterld field is absent. 

■ The Matrix field specifies the position, scale and rotation of the character being added 
or modified. 

■ The ColorTransform field specifies the color effect applied to the character being added 
or modified. 

■ The Ratio field specifies a morph ratio for the character being added or modified. This 
field applies only to characters defined with DefmeMorphShape, and controls how far the 
morph has progressed. A ratio of zero displays the character at the start of the morph. A 
ratio of 65535 displays the character at the end of the morph. For values between zero and 
65535 Flash Player interpolates between the start and end shapes, and displays an in- 
between shape. 

■ The ClipDepth field specifies the top-most depth that will be masked by the character 
being added. A ClipDepth of zero indicates that this is not a clipping character. 

■ The Name field specifies a name for the character being added or modified. This field is 
typically used with sprite characters, and is used to identify the sprite for SetTarget 
actions. It allows the main file (or other sprites) to perform actions inside the sprite (see 
Sprites and Movie Clips). 

■ The ClipActions field, which is valid only for placing sprite characters, defines one or 
more event handlers to be invoked when certain events occur. 
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The minimum file format version is SWF 3. 


PlaceObject2 


Field 

Type 

Comment 

Header 

RECORDHEADER 

Tag type = 26 

PlaceFlagHasClipActions 

UB[1] 

SWF 5 and later: has clip 
actions (sprite characters 
only) 

Otherwise: always 0 

PlaceFlagHasClipDepth 

UB[1] 

Has clip depth 

PlaceFlagHasName 

UB[1] 

Has name 

PlaceFlagHasRatio 

UB[1] 

Has ratio 

PlaceFlagHasColorT ransform 

UB[1] 

Has color transform 

PlaceFlagHasMatrix 

UB[1] 

Has matrix 

PlaceFlagHasCharacter 

UB[1] 

Places a character 

PlaceFlagMove 

UB[1] 

Defines a character to be 

moved 

Depth 

UI16 

Depth of character 

Characterld 

If PlaceFlagHasCharacter 

UI16 

ID of character to place 

Matrix 

If PlaceFlagHasMatrix 

MATRIX 

Transform matrix data 

ColorTransform 

If 

PlaceFlagHasColorTransform 
CXFORMWITHALPHA 

Color transform data 

Ratio 

If PlaceFlagHasRatio UI16 


Name 

If PlaceFlagHasName 

STRING 

Name of character 

ClipDepth 

If PlaceFlagHasClipDepth UI16 Clip depth 

(see Clipping layers) 

ClipActions 

If PlaceFlagHasClipActions 
CLIPACTIONS 

SWF 5 and later: 

Clip Actions Data 
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Clip actions are valid for placing sprite characters only. Clip actions define event handlers for 
a sprite character. 


CLIPACTIONS 



Field 

Type 

Comment 

Reserved 

UI16 

Must be 0 

AIIEventFlags 

CLIPEVENTFLAGS 

All events used In these clip 
actions 

ClipActionRecords 

CLIPACTIONRECORD 
[one or more] 

Individual event handlers 

ClipActionEndFlag 

If SWF version <= 5, UI16 

If SWF version >= 6, UI32 

Must be 0 


CLIPACTIONRECORD 



Field 

Type 

Comment 

EventFlags 

CLIPEVENTFLAGS 

Events to which this handler 
applies 

ActionRecordSize 

UI32 

Offset In bytes from end of this 
field to next 

CLIPACTIONRECORD (or 
ClipActionEndFlag) 

KeyCode 

If EventFlags contain 
CllpEventKeyPress: UI8 
Otherwise absent 

Key code to trap (see 
BUTTONCONDACTION) 

Actions 

ActlonRecord 
[one or more] 

Actions to perform 


PlaceObjectS 

The PlaceObjectS tag extends the functionality of the PlaceObject2 tag. PlaceObjectS adds 
the following new features: 

■ The PlaceFlagHasCacheAsBitmap field specifies whether Flash Player should internally 
cache a display object as a bitmap. Caching can speed up rendering when the object does 
not change frequently. 
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■ A number of different blend modes can be specified as an alternative to normal alpha 
compositing. The following blend modes are supported: 


Add 

Layer 


Alpha 

Lighten 


Darken 

Overlay 


Difference 

Multiply 


Erase 

Screen 


Hardlight 

Subtract 


Invert 



■ A number of bitmap filters can be applied to the display object. Adding filters implies that 
the display object will be cached as a bitmap. The following bitmap filters are supported: 

Bevel 

Drop shadow 


Blur 

Glow 


Color matrix 

Gradient bevel 


Convolution 

Gradient glow 


The minimum file format version is SWF 8. 


PlaceObject3 



Field 

Type 

Comment 

Header 

RECORDHEADER 

Tag type = 70 

PlaceFlagHasClipActions 

UB[1] 

SWF 5 and later: has clip 
actions (sprite characters 
only) 

Otherwise: always 0 

PlaceFlagHasClipDepth 

UB[1] 

Has clip depth 

PlaceFlagHasName 

UB[1] 

Has name 

PlaceFlagHasRatio 

UB[1] 

Has ratio 

PlaceFlagHasColorT ransform 

UB[1] 

Has color transform 

PlaceFlagHasMatrix 

UB[1] 

Has matrix 

PlaceFlagHasCharacter 

UB[1] 

Places a character 

PlaceFlagMove 

UB[1] 

Defines a character to be 

moved 
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PlaceObject3 



Field 

Type 

Comment 

Reserved 

UB[5] 

Must be 0 

PlaceFlagHasCacheAsBitmap 

UB[1] 

Enables bitmap caching 

PlaceFlagHasBIendMode 

UB[1] 

Has blend mode 

PlaceFlagFlasFilterList 

UB[1] 

Has filter list 

Depth 

UI16 

Depth of character 

Characterld 

If PlaceFlagHasCharacter 

UI16 

ID of character to place 

Matrix 

If PlaceFlagHasMatrix 

MATRIX 

Transform matrix data 

ColorTransform 

If 

PlaceFlagHasColorT ransform 
CXFORMWITHALPHA 

Color transform data 

Ratio 

If PlaceFlagHasRatIo UI16 


Name 

If PlaceFlagHasName STRING 

Name of character 

ClipDepth 

If PlaceFlagHasCIlpDepth UI16 

Clip depth 

(see Clipping layers) 

SurfaceFilterList 

If PlaceFlagHasFllterLIst 
FILTERLIST 

List of filters on this object 

Blend Mode 

If PlaceFlagHasBIendMode 

UI8 

0 or1 = normal 

2 = layer 

3 = multiply 

4 = screen 

5 = lighten 

6 = darken 

7 = add 

8 = subtract 

9 = difference 

10 = invert 

11 = alpha 

12 = erase 

13 = overlay 

14 = hardlight 

Values 15 to 255 are 

reserved. 

ClipActions 

If PlaceFlagHasCllpActlons 
CLIPACTIONS 

SWF 5 and later: 

Clip Actions Data 
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FILTERLIST 



Field 

Type 

Comment 

NumberOfFilters 

UI8 

Number of Filters 

Filter 

FILTER[NumberOfFilters] 

List of filters 


FILTER 



Field 

Type 

Comment 

FilterlD 

UI8 

0 = Has DropShadowFilter 

1 = Has BlurFilter 

2 = Has GlowFilter 

3 = Has BevelFilter 

4 = Has 

GradientGlowFilter 

5 = Has ConvolutionFilter 

6 = Has ColorMatrixFilter 

7= Has 

GradientBevelFilter 

DropShadowFilter 

If FilterlD = 0 

DROPSHADOWFILTER 

Drop Shadow filter 

BlurFilter 

If FilterlD = 1 

BLURFILTER 

Blur filter 

GlowFilter 

If FilterlD = 2 

GLOWFILTER 

Glow filter 

BevelFilter 

If FilterlD = 3 

BEVELFILTER 

Bevel filter 

GradientGlowFilter 

If FilterlD = 4 

GRADIENTGLOWFILTER 

Gradient Glow filter 

ConvolutionFilter 

If FilterlD = 5 

CONVOLUTIONFILTER 

Convolution filter 

ColorMatrixFilter 

If FilterlD = 6 

COLORMATRIXFILTER 

Color Matrix filter 

GradientBevelFilter 

If FilterlD = 7 

GRADIENTBEVELFILTER 

Gradient Bevel filter 
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Color Matrix filter 


A Color Matrix filter applies a color transformation on the pixels of a display list object. Given 
an input RGBA pixel in a display list object, the color transformation is calculated in the 
following way: 

rO rl r2 r3 r4 R 
gO gl g2 g3 g4 G 
bO bl b2 b3 b4 B 
aO al a2 a3 a4 A 
0 0 0 0 1 1 


The resulting RGBA values are saturated. 

The matrix values are stored from left to right and each row from top to bottom. The last row 
is always assumed to be (0,0,0,0,1) and does not need to be stored. 


COLORMATRIXFILTER 



Field 

Type 

Comment 

Matrix 

FLOAT[20] 

Color matrix values 


Convolution filter 

The Convolution filter is a two-dimensional discrete convolution. It is applied on each pixel 
of a display object. In the following mathematical representation, F is the input pixel plane, G 
is the input matrix, and H is the output pixel plane: 

MatrixY - 1 MatrixX - 1 

f-cl' MatrixXir , ■ MatrixYl , 

Htx][y] = ^ ^ [F^x + i - - -J^y+j- - -J + BiasjGti](j] 

Divisor 
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The convolution is applied on each of the RGBA color components and then saturated, 
except when the PreserveAlpha flag is set; in this case, the alpha channel value is not modified. 
The clamping flag specifies how pixels outside of the input pixel plane are handled. If set to 
false, the DefaultColor value is used, and otherwise, the pixel is clamped to the closest valid 
input pixel. 


CONVOLUTIONFILTER 



Field 

Type 

Comment 

MatrixX 

UI8 

Horizontal matrix size 

MatrixY 

UI8 

Vertical matrix size 

Divisor 

FLOAT 

Divisor applied to the 
matrix values 

Bias 

FLOAT 

Bias applied to the matrix 
values 

Matrix 

FLOAT[MatrixX * MatrixY] 

Matrix values 

DefaultColor 

RGBA 

Default color for pixels 
outside the image 

Reserved 

UB[6] 

Must be 0 

Clamp 

UB[1] 

Clamp mode 

PreserveAlpha 

UB[1] 

Preserve the alpha 


Blur filter 


The blur filter is based on a sub-pixel precise median filter (also known as a box filter). The 
filter is applied on each of the RGBA color channels. 

The general mathematical representation of a simple non-sub-pixel precise median filter is as 
follows, and can be easily extended to support sub-pixel precision. 


z 

o 

H 

m 


This representation assumes that BlurY and BlurX are odd integers in order to get the 
same result as Flash Player. The filter window is always centered on a pixel in Flash 
Player). 


H[x][y] 


BlurY-1 BlurX-1 


X 

j = 0 


i = 0 _ 

(BlurXRBlurY) 


BlurY " 
2 _ 
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When the number of passes is set to three, it closely approximates a Gaussian Blur filter. A 
higher number of passes is possible, but for performance reasons, Macromedia does not 
recommend it. 


BLURFILTER 

Field 

Type 

Comment 

BlurX 

FIXED 

Horizontal blur amount 

BlurY 

FIXED 

Vertical blur amount 

Passes 

UB[5] 

Number of blur passes 

Reserved 

UB[3] 

Must be 0 


Drop Shadow filter 

The Drop Shadow filter is based on the same median filter as the blur filter, but the filter is 
applied only on the alpha color channel to obtain a shadow pixel plane. 

The angle parameter is in radians. With angle set to 0, the shadow shows on the right side of 
the object. The distance is measured in pixels. The shadow pixel plane values are interpolated 
bilinearly if sub-pixel values are used. 

The strength of the shadow normalized is 1.0 in fixed point. The strength value is applied by 
multiplying each value in the shadow pixel plane. 

Various compositing options are available for the drop shadow to support both inner and 
outer shadows in regular or knockout modes. 

The resulting color value of each pixel is obtained by multiplying the color channel of the 
provided RGBA color value by the associated value in the shadow pixel plane. The resulting 
pixel value is composited on the original input pixel plane by using one of the specified 
compositing modes. 


DROPSHADOWFILTER 



Field 

Type 

Comment 

DropShadowColor 

RGBA 

Color of the shadow 

BlurX 

FIXED 

Horizontal blur amount 

BlurY 

FIXED 

Vertical blur amount 

Angle 

FIXED 

Radian angle of the drop 
shadow 

Distance 

FIXED 

Distance of the drop 
shadow 
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DROPSHADOWFILTER 



Field 

Type 

Comment 

Strength 

FIXED8 

Strength of the drop 
shadow 

InnerShadow 

UB[1] 

Inner shadow mode 

Knockout 

UB[1] 

Knockout mode 

CompositeSource 

UB[1] 

Composite source 

Always 1 

Passes 

UB[5] 

Number of blur passes 

Glow filter 



The Glow filter works in the same way as the Drop Shadow filter, except that it does not have 
a distance and angle parameter. Therefore, it can run slightly faster. 

GLOWFILTER 



Field 

Type 

Comment 

GlowColor 

RGBA 

Color of the shadow 

BlurX 

FIXED 

Horizontal blur amount 

BlurY 

FIXED 

Vertical blur amount 

Strength 

FIXED8 

Strength of the glow 

InnerGlow 

UB[1] 

Inner glow mode 

Knockout 

UB[1] 

Knockout mode 

CompositeSource 

UB[1] 

Composite source 

Always 1 

Passes 

UB[5] 

Number of blur passes 
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Bevel filter 

The Bevel filter creates a smooth bevel on display list objects. 


BEVELFILTER 



Field 

Type 

Comment 

ShadowColor 

RGBA 

Color of the shadow 

HighlightColor 

RGBA 

Color of the highlight 

BlurX 

FIXED 

Horizontal blur amount 

BlurY 

FIXED 

Vertical blur amount 

Angle 

FIXED 

Radian angle of the drop 
shadow 

Distance 

FIXED 

Distance of the drop 
shadow 

Strength 

FIXED8 

Strength of the drop 
shadow 

InnerShadow 

UB[1] 

Inner shadow mode 

Knockout 

UB[1] 

Knockout mode 

CompositeSource 

UB[1] 

Composite source 

Always 1 

OnTop 

UB[1] 

OnTop mode 

Passes 

UB[4] 

Number of blur passes 


Gradient Glow and Gradient Bevel filters 

The Gradient Glow and Gradient Bevel filters are extensions of the normal Glow and Bevel 
Filters and allow a gradient to be specified instead of a single color. Instead of multiplying a 
single color value by the shadow-pixel plane value, the shadow-pixel plane value is mapped 
directly into the gradient ramp to obtain the resulting color pixel value, which is then 
composited by using one of the specified compositing modes. 

GRADIENTGLOWFILTER 


Field 

Type 

Comment 

NumColors 

UI8 

Number of colors In the 



gradient 

GradlentColors 

RGBA[NumColors] 

Gradient colors 

GradlentRatlo 

UI8[NumColors] 

Gradient ratios 
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GRADIENTGLOWFILTER 



Field 

Type 

Comment 

BlurX 

FIXED 

Horizontal blur amount 

BlurY 

FIXED 

Vertical blur amount 

Angle 

FIXED 

Radian angle of the 
gradient glow 

Distance 

FIXED 

Distance of the gradient 
glow 

Strength 

FIXED8 

Strength of the gradient 
glow 

InnerShadow 

UB[1] 

Inner glow mode 

Knockout 

UB[1] 

Knockout mode 

CompositeSource 

UB[1] 

Composite source 

Always 1 

OnTop 

UB[1] 

OnTop mode 

Passes 

UB[4] 

Number of blur passes 


GRADIENTBEVELFILTER 


Field 

Type 

Comment 

NumColors 

UI8 

Number of colors In the 
gradient 

GradlentColors 

RGBA[NumColors] 

Gradient colors 

GradlentRatIo 

UI8[NumColors] 

Gradient ratios 

BlurX 

FIXED 

Horizontal blur amount 

BlurY 

FIXED 

Vertical blur amount 

Angle 

FIXED 

Radian angle of the 
gradient bevel 

Distance 

FIXED 

Distance of the gradient 
bevel 

Strength 

FIXED8 

Strength of the gradient 
bevel 

InnerShadow 

UB[1] 

Inner bevel mode 

Knockout 

UB[1] 

Knockout mode 
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GRADIENTBEVELFILTER 



Field 

Type 

Comment 

CompositeSource 

UB[1] 

Composite source 

Always 1 

OnTop 

UB[1] 

OnTop mode 

Passes 

UB[4] 

Number of blur passes 

ClipEventFlags 



The CLIPEVENTFLAGS sequence specifies one or more sprite events to which an event 
handler applies. In SWF 5 and earlier, CLIPEVENTFLAGS is 2 bytes; in SWF 6 and later, it 
is 4 bytes. 

CLIPEVENTFLAGS 



Field 

Type 

Comment 

ClipEventKeyUp 

UB[1] 

Key up event 

ClipEventKeyDown 

UB[1] 

Key down event 

ClipEventMouseUp 

UB[1] 

Mouse up event 

ClipEventMouseDown 

UB[1] 

Mouse down event 

ClipEventMouseMove 

UB[1] 

Mouse move event 

ClipEventUnload 

UB[1] 

Clip unload event 

ClipEventEnterFrame 

UB[1] 

Frame event 

ClipEventLoad 

UB[1] 

Clip load event 

ClipEventDragOver 

UB[1] 

SWF 6 and later: mouse 
drag over event 

Otherwise: always 0 

ClipEventRollOut 

UB[1] 

SWF 6 and later: mouse 

rollout event 

Otherwise: always 0 

ClipEventRollOver 

UB[1] 

SWF 6 and later: mouse 
rollover event 

Otherwise: always 0 

ClipEventReleaseOutside 

UB[1] 

SWF 6 and later: mouse 

release outside event 
Otherwise: always 0 
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CLIPEVENTFLAGS 

Field 

Type 

Comment 

ClipEventRelease 

UB[1] 

SWF 6 and later: mouse 

release inside event 
Otherwise: always 0 

ClipEventPress 

UB[1] 

SWF 6 and later: mouse 
press event 

Otherwise: always 0 

ClipEventInitialize 

UB[1] 

SWF 6 and later: initialize 

event 

Otherwise: always 0 

ClipEventData 

UB[1] 

Data received event 

Reserved 

If SWF version >= 6 
UB[5] 

Always 0 

ClipEventConstruct 

If SWF version >= 6 
UB[1] 

SWF 7 and later: construct 

event 

Otherwise: always 0 

ClipEventKeyPress 

If SWF version >= 6 
UB[1] 

Key press event 

ClipEventDragOut 

If SWF version >= 6 
UB[1] 

Mouse drag out event 

Reserved 

If SWF version >= 6 
UB[8] 

Always 0 


The extra events added in SWF 6 correspond to the Flash button movie clips, which are sprites 
that can be scripted in the same way as buttons (see BUTTONCONDACTION). The 
DragOut through Press events correspond to the button state transition events in button 
action conditions; the correspondence between them is shown in the description of Button 
events (see Events, state transitions, and actions). 

The KeyDown and KeylJp events are not specific to a particular key; handlers for these events 
are executed whenever any key on the keyboard (with the possible exception of certain special 
keys) transitions to the down state or up state, respectively. To find out what key made the 
transition, actions within a handler should call methods of the ActionScript Key object. 

The KeyPress event works differently from KeyDown and KeylJp. KeyPress is specific to a 
particular key or ASCII character (which is specified in the CLIPACTIONRECORD). 
KeyPress events work in an identical way (see BUTTONCONDACTION). 
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RemoveObject 

The RemoveObject tag removes the specified character (at the specified depth) from the 
display list. 

The minimum file format version is SWF 1. 


RemoveObject 



Field 

Type 

Comment 

Header 

RECORDHEADER 

Tag type = 5 

Characterld 

UI16 

ID of character to remove 

Depth 

UI16 

Depth of character 


RennoveObject2 

The RemoveObject2 tag removes the character at the specified depth from the display list. 
The minimum file format version is SWF 3. 


RemoveObject2 

Field 

Type 

Comment 

Header 

RECORDHEADER 

Tag type = 28 

Depth 

UI16 

Depth of character 

ShowFrame 

The ShowFrame tag instructs Flash Player to display the 
paused for the duration of a single frame. 

The minimum file format version is SWF 1. 

contents of the display list. The file is 

ShowFrame 

Field 

Type 

Comment 

Header 

RECORDHEADER 

Tag type = 1 
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CHAPTER 6 


6 


Control Tags 


Control tags manage some overall aspects of files, frames, and playback in Macromedia Flash 
(SWF) files. 


SetBackgroundColor 

The SetBackgroundColor tag sets the background color of the display. 
The minimum file format version is SWF 1. 


SetBackgroundColor 

Field 

Type 

Comment 

Header 

BackgroundColor 

RECORDHEADER 

RGB 

Tag type = 9 

Color of the display background 

FrameLabel 



The FrameLabel tag gives the specified Name to the current frame. ActionGoToLabel uses 
this name to identify the frame. 

The minimum file format version is SWF 3. 

FrameLabel 

Field 

Type 

Comment 

Header 

Name 

RECORDHEADER 

STRING 

Tag type = 43 

Label for frame 
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In SWF files of version 6 or later, an extension to the FrameLabel tag called named anchors is 
available. A named anchor is a special kind of frame label that, in addition to labeling a frame 
for seeking using ActionGoToLabel, labels the frame for seeking using HTML anchor syntax. 
The browser plug-in versions of the Macromedia Flash Player, in version 6 and later, will 
inspect the URL in the browser’s Location bar for an anchor specification (a trailing phrase of 
the form #anchorname). If an anchor specification is present in the Location bar. Flash Player 
will begin playback starting at the frame that contains a FrameLabel tag that specifies a named 
anchor of the same name, if one exists; otherwise playback will begin at Frame 1 as usual. In 
addition, when Flash Player arrives at a frame that contains a named anchor, it will add an 
anchor specification with the given anchor name to the URL in the browser’s Location bar. 
This ensures that when users create a bookmark at such a time, they can later return to the 
same point in the Flash file, subject to the granularity at which named anchors are present 
within the file. 

To create a named anchor, insert one additional non-null byte after the null terminator of the 
anchor name. This is valid only for SWF 6 or later. 


NamedAnchor 



Field 

Type 

Comment 

Header 

RECORDHEADER 

Tag type = 43 

Name 

Null-terminated STRING. (0 
is NULL) 

Label for frame. 

Named Anchor flag 

UI8 

Always 1 


Protect 

The Protect tag marks a file as not importable for editing in an authoring environment. If the 
Protect tag contains no data (tag length = 0), the SWF file cannot be imported. If this tag is 
present in the file, any authoring tool should prevent the file from loading for editing. 

If the Protect tag does contain data (tag length is not 0), the SWF file can be imported if the 
correct password is specified. The data in the tag is a null-terminated string that specifies an 
MD5 encrypted password. Specifying a password is only supported in SWF 5 or later. 

The MD5 password encryption algorithm used was written by Poul-Henning Kamp and is 
freely distributable. It resides in the FreeBSD tree at src/lib/libcrypt/crypt-md5.c. The 
EnableDebugger tag also uses MD5 password encryption algorithm. 
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The minimum file format 

version is SWF 2. 


Protect 



Field 

Type 

Comment 

Header 

RECORDHEADER 

Tag type = 24 

End 



The End tag marks the end of a file. This must always be the last tag in a file. The End tag is 
also required to end a sprite definition. 

The minimum file format version is SWF 1. 


End 



Field 

Type 

Comment 

Header 

RECORDHEADER 

Tag type = 0 


ExportAssets 

The ExportAssets tag makes portions of a SWF file available for import by other SWF files 
(see ImportAssets). For example, ten Flash files that are all part of the same website can share 
an embedded custom font if one file embeds the font and exports the font character. Each 
exported character is identified by a string. Any type of character can be exported. 

If the value of the character in ExportAssets was previously exported with a different identifier, 
Flash Player associates the tag with the latter identifier. That is, if Flash Player has already read 
a given value for Tag1 and the same Tag1 value is read later in the SWF file, the second Name1 
value is used. 

The minimum file format version is SWF 5. 

Export Assets 

Field Type Comment 

Header RECORDHEADER Tag type = 56 

Count UI16 Number of assets to export 

Tag1 UI16 First character ID to export 

Name1 STRING Identifier for first exported 

character 
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Export Assets 



Field 

Type 

Comment 

TagN 

UI16 

Last character ID to export 

NameN 

STRING 

Identifier for last exported 
character 

Import Assets 


The ImportAssets tag imports characters from another SWF file. The importing SWF file 
references the exporting SWF file by the URL where it can be found. Imported assets are 
added to the dictionary just like characters defined within a SWF file. 

The URL of the exporting SWF file can be absolute or relative. If it is relative, it will be 
resolved relative to the location of the importing SWF file. 

The ImportAssets tag must be earlier in the frame than any later tags that rely on the 
imported assets. 

The ImportAssets tag was deprecated in SWF 8; Flash Player 8 or later ignores this tag. In 
SWF 8 or later, use the ImportAssets2 tag instead. 

The minimum file format version is SWF 5, and the maximum file format version is SWF 7. 

ImportAssets 



Field 

Type 

Comment 

Header 

RECORDHEADER 

Tag type = 57 

URL 

STRING 

URL where the source 

SWF file can be found 

Count 

UI16 

Number of assets to import 

Tag1 

UI16 

Character ID to use for first 
imported character in 
importing SWF file (need 
not match character ID in 
exporting SWF file) 

Name1 

STRING 

Identifier for first imported 
character (must match an 
identifier in exporting SWF 
file) 
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ImportAssets 



Field 

Type 

Comment 

TagN 

UI16 

Character ID to use for last 
imported character in 
importing SWF file 

NameN 

STRING 

Identifier for last imported 
character 


EnableDebugger 

The EnableDebugger tag enables debugging. The password in the EnableDebugger tag is 
encrypted by using the MD5 algorithm, in the same way as the Protect tag. 

The EnableDebugger tag was deprecated in SWF 6; Flash Player 6 or later ignores this tag 
because the format of the debugging information required in the ActionScript debugger was 
changed in SWF 6. In SWF 6 or later, use the EnableDebugger2 tag instead. 

The minimum and maximum file format version is SWF 5. 


EnableDebugger 



Field 

Type 

Comment 

Header 

RECORDHEADER 

Tag type = 58 

Password 

Null-terminated STRING. (0 
is NULL) 

MD5-encrypted password 

EnableDebugger2 


The EnableDebugger2 tag enables debugging. The Password field is encrypted by using the 
MD5 algorithm, in the same way as the Protect tag. 

The minimum file format 

version is SWF 6. 


EnableDebugger2 



Field 

Type 

Comment 

Header 

RECORDHEADER 

Tag type = 64 

Reserved 

UI16 

Always 0 

Password 

Null-terminated STRING. (0 
is NULL) 

MDS-encrypted password 
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ScriptLimits 

The ScriptLimits tag includes two fields that can be used to override the default settings for 
maximum recursion depth and ActionScript time-out: MaxRecursionDepth and 
ScriptTimeoutSeconds. 

The MaxRecursionDepth field sets the ActionScript maximum recursion limit. The default 
setting is 256 at the time of this writing. This default can be changed to any value greater 
than zero (0). 

The ScriptTimeoutSeconds field sets the maximum number of seconds the player should 
process ActionScript before displaying a dialog box asking if the script should be stopped. 

The default value for ScriptTimeoutSeconds varies by platform and is between 15 to 20 
seconds. This default value is subject to change. 

The minimum file format version is SWF 7. 


ScriptLimits 



Field 

Type 

Comment 

Header 

RECORDHEADER 

Tag type = 65 

MaxRecursionDepth 

UI16 

Maximum recursion depth 

ScriptTimeoutSeconds 

UI16 

Maximum ActionScript 
processing time before 
script stuck dialog box 
displays 


SetTabIndex 

Flash Player maintains a concept of tab order of the interactive and textual objects displayed. 
Tab order is used both for actual tabbing and, in SWF 6 and later, to determine the order in 
which objects are exposed to accessibility aids (such as screen readers). The SWF 7 
SetTabIndex tag sets the index of an object within the tab order. 

If no character is currently placed at the specified depth, this tag is ignored. 

You can also use using the ActionScript tabindex property to establish tab ordering, but this 
does not provide a way to set a tab index for a static text object, because the player does not 
provide a scripting reflection of static text objects. Fortunately, this is not a problem for the 
purpose of tabbing, because static text objects are never actually tab stops. However, this is a 
problem for the purpose of accessibility ordering, because static text objects are exposed to 
accessibility aids. When generating SWF content that is intended to be accessible and 
contains static text objects, the SetTabIndex tag is more useful than the tabindex property. 
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The minimum file format version is SWF 7. 


SetTabIndex 



Field 

Type 

Comment 

Header 

RECORDHEADER 

Tag type = 66 

Depth 

UI16 

Depth of character 

Tabindex 

UI16 

Tab order value 


FileAttributes 

The FileAttributes tag defines characteristics of the SWF file. This tag is required for SWF 8 
and later and must be the first tag in the SWF file. Additionally, the FileAttributes tag can 
optionally be included in all SWF file versions. 

The HasMetadata flag identifies whether the SWF file contains the Metadata tag. 

The UseNetwork flag signifies whether Flash Player should grant the SWF local or network 
file access if the SWF file is loaded locally. Flash Player 8 introduced security restrictions on 
the privileges of SWF files loaded from local file systems. The default behavior is to allow local 
SWF files to interact with local files only, and not with the network. However, by setting the 
UseNetwork flag, the local SWF can forfeit its local file system access in exchange for access to 
the network. Any version of SWF can use the UseNetwork flag to set the file access for locally 
loaded SWF files for Flash Player 8 or later. For further detail about Flash Player 8 security 
changes, refer to http://www.macromedia.com/devnet/flash/articles/fplayer8_security.html. 
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The minimum file format version is SWF 1. 


FileAttributes 



Field 

Type 

Comment 

Header 

RECORDHEADER 

Tag type = 69 

Reserved 

UB[3] 

Must be 0 

HasMetadata 

UB[1] 

If 1, the SWF file contains 
the Metadata tag 

If 0, the SWF file does not 
contain the Metadata tag 

Reserved 

UB[3] 

Must be 0 

UseNetwork 

UB[1] 

If 1, this SWF file is given 
network file access when 
loaded locally 

If 0, this SWF file is given 
local file access when 
loaded locally 

Reserved 

UB[24] 

Must be 0 


lnnportAssets2 

The ImportAssets2 tag replaces the ImportAssets tag for SWF 8 and later. ImportAssets2 
currently mirrors the ImportAssets tag’s functionality. 

The ImportAssets2 tag imports characters from another SWF file. The importing SWF file 
references the exporting SWF file by the URL where it can be found. Imported assets are 
added to the dictionary just like characters defined within a SWF file. 

The URL of the exporting SWF file can be absolute or relative. If it is relative, it is resolved 
relative to the location of the importing SWF file. 

The ImportAssets2 tag must be earlier in the frame than any later tags that rely on the 
imported assets. 
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The minimum file format version is SWF 8. 


lmportAssets2 



Field 

Type 

Comment 

Header 

RECORDHEADER 

Tag type = 71 

URL 

STRING 

URL where the source 

SWF file can be found 

Reserved 

UI8 

Must be 1 

Reserved 

UI8 

Must be 0 

Count 

UI16 

Number of assets to import 

Tag1 

UI16 

Character ID to use for first 
imported character in 
importing SWF file (need 
not match character ID in 
exporting SWF file) 

Name1 

STRING 

Identifier for first imported 
character (must match an 
identifier in exporting SWF 
file) 

TagN 

UI16 

Character ID to use for last 
imported character in 
importing SWF file 

NameN 

STRING 

Identifier for last imported 
character 


Metadata 

The Metadata tag is an optional tag to describe the SWF file to an external process. The tag 
embeds XML metadata in the SWF file so that, for example, a search engine can locate this 
tag, access a title for the SWF file, and display that title in search results. Flash Player always 
ignores the Metadata tag. 

If the Metadata tag is included in a SWF file, the FileAttributes tag must also be in the SWF 
file with its HasMetadata flag set. Conversely, if the FileAttributes tag has the HasMetadata 
flag set, the Metadata tag must be in the SWF file. The Metadata tag can only be in the SWF 
file one time. 


Metadata 
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The format of the metadata is RDF that is compliant with the XMP specification. For more 
information about RDF and XMP, see the following sources: 

■ The RDF Primer at http://www.w3.org/TR/rdf-primer/ 

■ The RDF Specification at http://www.w3.org/TR/1999/REC-rdf-syntax-19990222/ 

■ The XMP home page at http://www.adobe.com/products/xmp/ 

The following examples show two of many acceptable ways to represent the Metadata string 
in the SWF file. The first example provides basic information about the SWF file, the title 
and description: 

<rdf:RDF xnilns:rdf=’http: //www. w3 .org/1999/02/22-rdf-syntax-ns#’> 
<rdf:Description rdf:about=’’ xnilns:dc=’http://purl .org/dc/l.l’> 
<dc:title>Siniple Title</dc:title> 

<dc:description>Simple Description</dc:description> 

</rdf:Description> 

</rdf:RDF> 

In the second example, the title is described for multiple languages: 

<rdf:RDF xnilns:rdf=’http: / /www. w3 .org/1999/02/22-rdf-syntax-ns#’> 
<rdf:Description rdf:about=’’ xmlns:dc=’http://purl.org/dc/l.l’> 

<dc:title> 

<rdf: A11> 

<rdf:li xml:1ang=’x-default’>Default Title</rdf: 1i> 

<rdf:li xml:1ang=’en-us’>US English Title</rdf:1i> 

<rdf:li xml:1ang=’fr-fr’>Titre Frangais</rdf:1i> 

<rdf:li xml:1ang=’it-it’>Titol 0 Italiano</rdf:1i> 

</rdf:Alt> 

</dc:title> 

<dc:description>Simple Description</dc:description> 

</rdf:Description> 

</rdf:RDF> 

The Metadata string is stored in the SWF file with all unnecessary white space removed. 

The minimum file format version is SWF 1. 


Metadata 



Field 

Type 

Comment 

Header 

RECORDHEADER 

Tag type = 77 

Metadata 

STRING 

XML Metadata 
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DefineScalingGrid 

The DefineScalingGrid tag introduces the concept of 9-slice scaling, which allows 
component-style scaling to be applied to a sprite or button character. 

When the DefineScalingGrid tag associates a character with a 9-slice grid, Flash Player 
conceptually divides the sprite or button into nine sections with a grid-like overlay. When the 
character is scaled, each of the nine areas is scaled independently. To maintain the visual 
integrity of the character, corners are not scaled, while the remaining areas of the image are 
scaled larger or smaller, as needed. 

DefineScalingGrid 

Field Type Comment 

Header RECORDHEADER Tag type = 78 

Characterld UI16 ID of sprite or button 

character upon which the 
scaling grid will be applied. 

Splitter RECT Center region of 9-slice 

grid 

The Splitter rectangle specifies the center portion of the nine regions of the scaling grid, and 
from this rectangle Flash Player derives the 9-slice grid. The width and height of the rectangle 
must be at least one twip each (1/20 pixel), or Flash Player ignores the DefineScalingGrid tag. 
When a sprite or button with a DefineScalingGrid association is scaled, the nine regions of 
the character scale according to the following table: 


No scale 

Horizontal scale 

No scale 

Vertical scale 

Horizontal and 
vertical scale 

Vertical scale 

No scale 

Horizontal seale 

No scale 


9-slice scaling does not affect the children of or any text within, the specified character. These 
objects transform normally. 

The sprite or button with a DefineScalingGrid association cannot be rotated or skewed, and 
doing so disables 9-slice behavior. However, this limitation does not apply to parents or 
children of the 9-slice object, and parent rotation or skew is applied to the 9-slice objects in 
the normal manner. 
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Flash Player stretches any fills in the character to fit the shape. 

9-slice scaling does not affect the bounds or origin of any object. 

If a 9-slice character is scaled below its original size, the five scaling regions are consumed until 
they become very small. Once the minimum size is reached, Flash Player reverts to normal, 
non-9-slice scaling. 

The minimum file format version is SWF 8. 
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CHAPTER 7 

Actions 


Actions are an essential part of an interactive Macromedia Flash (SWF) file. Actions allow a 
file to react to events such as mouse movements or mouse clicks. The SWF 3 action model 
and earlier supports a simple action model. The SWF 4 action model supports a greatly 
enhanced action model that includes an expression evaluator, variables, and conditional 
branching and looping. The SWF 5 action model adds a JavaScript-sryle object model, data 
types and functions. 


SWF 3 action model 


The SWF 3 action 

model consists of eleven 

instructions for Flash Player: 

Instruction 

See 

Description 

Play 

Act!onPlay 

Start playing at the current frame 

Stop 

Act!onStop 

Stop playing at the current frame 

NextFrame 

ActionNextFrame 

Go to the next frame 

PreviousFrame 

ActionPreviousFrame 

Go to the previous frame 

GotoFrame 

Act!onGotoFrame 

Go to the specified frame 

GotoLabel 

ActionGoToLabel 

Go to the frame with the specified label 

WaitForFrame 

ActionWaitForFrame 

Wait for the specified frame 

GetURL 

ActionGetURL 

Get the specified URL 

StopSounds 

ActionStopSounds 

Stop all sounds playing 

ToggleQuality 

ActionToggleQuality 

Toggle the display between high and low 
quality 

SetTarget 

ActionSetTarget 

Change the context of subsequent actions to a 
named object 
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An action (or list of actions) can be triggered by a button state transition, or by SWF 3 
actions. The action is not executed immediately, but is added to a list of actions to be 
processed. The list is executed on a ShowFrame tag, or after the button state has changed. An 
action can cause other actions to be triggered, in which case, the action is added to the list of 
actions to be processed. Actions are processed until the action list is empty. 

By default. Timeline actions such as Stop (see ActionStop), Play (see ActionPlay), and 
GoToFrame (see ActionGotoFrame) apply to files that contain them. However, the SetTarget 
action (see ActionSetTarget), which is called Tell Target in the Macromedia Flash user 
interface, can be used to send an action command to another file or sprite (see DefmeSprite). 

SWF 3 actions 

The actions in this section are available in SWF 3. 

DoAction 

DoAction instructs Flash Player to perform a list of actions when the current frame is 
complete. The actions are performed when the ShowFrame tag is encountered, regardless of 
where in the frame the DoAction tag appears. 


Field 

Type 

Comment 

Header 

RECORDHEADER 

Tag type = 12 

Actions 

ACTIONRECORD [zero or more] 

List of actions to perform (see 
following table, ActionRecord) 

ActionEndFlag 

UI8 = 0 

Always set to 0 

ActionRecord 

An action record consists of a 1-byte action code. If the high bit of the action code is set, a 16- 

bit length describes the 

: amount of data that the action uses. If the high bit is clear, the action 

has no data. 

Field 

Type 

Comment 

ActionCode 

code = UI8 

An action code (see following) 

Length 

If code >= 0x80 UI16 

The number of bytes (after this) in 
the ACTIONRECORD. 
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ActionGotoFrame 

ActionGotoFrame instructs Flash Player to go to the specified frame in the current file. 


Field 

Type 

Comment 

ActionGotoFrame 

UI8 

Action = 0x81 

Length 

UI16 

Always 2 

Frame 

UI16 

Frame index 

ActionGetURL 



ActionGetURL instructs Flash Player to get the URL that UrlString specifies. The URL can 
be of any type, including an HTML file, an image or another SWF file. If the file is playing in 
a browser, the URL is displayed in the frame that TargetString specifies. The "_levelO" and 
"_levell" special target names are used to load another SWF file into levels 0 and 1 
respectively. 

Field 

Type 

Comment 

ActionGetURL 

UI8 

Action = 0x83 

Length 

UI16 

Combined length of strings 

UrlString 

STRING 

Target URL string 

Targetstring 

STRING 

Target string 

ActionNextFrame 



ActionNextFrame instructs Flash Player to go to the next frame in the current file. 

Field 

Type 

Comment 

ActionNextFrame 

UI8 

Action = 0x04 

ActionPreviousFrame 


ActionPreviousFrame instructs Flash Player to go to the previous frame of the current file. 

Field 

Type 

Comment 

ActionPrevFrame 

UI8 

Action = 0x05 


SWF 3 action model 
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ActionPlay 

ActionPlay instructs Flash Player to start playing at the current frame. 


Field Type Comment 

ActionPlay UI8 Action = 0x06 

ActionStop 

ActionStop instructs Flash Player to stop playing the file at the current frame. 

Field Type Comment 

ActionStop UI8 Action = 0x07 

ActionToggleQuality 

ActionToggleQuality toggles the display between high and low quality. 

Field Type Comment 

ActionToggleQualty UI8 Action = 0x08 

ActionStopSounds 

ActionStopSounds instructs Flash Player to stop playing all sounds. 

Field Type Comment 

ActionStopSounds UI8 Action = 0x09 

ActionWaitForFrame 

ActionWaitForFrame instructs Flash Player to wait until the specified frame; otherwise skips 
the specified number of actions. 


Field Type Comment 


ActionWaitForFrame 

UI8 

Action = 0x8A 

Length 

UI16 

Always 3 

Frame 

UI16 

Frame to wait for 

SkipCount 

UI8 

Number of actions to skip if 



frame is not loaded 
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ActionSetTarget 

ActionSetTarget instructs Flash Player to change the context of subsequent actions, so they 
apply to a named object (TargetName) rather than the current file. 

For example, the SetTarget action can be used to control the Timeline of a sprite object. The 
following sequence of actions sends a sprite called "spinner" to the first frame in its 
Timeline: 

1 . SetTarget "spinner" 

2 . GotoFrame zero 

3 . SetTarget " " (empty string) 

4 . End of actions. (Act i on code = 0) 

All actions following SetTarget “spinner” apply to the spinner obj ect until SetTarget “ ”, 
which sets the action context back to the current file. For a complete discussion of target 
names see DefineSprite. 


Field 

Type 

Comment 

ActionSetTarget 

UI8 

Action = 0x8B 

Length 

UI16 

Length of record 

TargetName 

STRING 

Target of action target 


ActionGoT oLabel 

ActionGoToLabel instructs Flash Player to go to the frame associated with the specified label. 
You can attach a label to a frame with the FrameLabel tag. 


Field 

Type 

Comment 

ActionGoToLabel 

UI8 

Action = 0x8C 

Length 

UI16 

Length of record 

Label 

STRING 

Frame label 


SWF 4 action model 

The SWF 4 file format supports a greatly enhanced action model that includes an expression 
evaluator, variables, conditional branching and looping. 

Macromedia Flash Player 4 incorporates a stack machine that interprets and executes SWF 4 
actions. The key SWF 4 action is ActionPush. This action is used to push one or more 
parameters onto the stack. Unlike SWF 3 actions, SWF 4 actions do not have parameters 
embedded in the tag, rather they push parameters onto the stack, and pop results off the stack. 


SWF 4 action model 
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The expression evaluator is also stack based. Arithmetic operators include ActionAdd, 
ActionSubtract, ActionMultiply, and ActionDivide. The Flash authoring tool converts 
expressions to a series of stack operations. For example, the expression 1 +x*3 is represented as 
the following action sequence: 

ActionPush "x" 

ActionGetVariabl e 
ActionPush "3" 

ActionMultiply 
ActionPush "1" 

ActionAdd 

The result of this expression is on the stack. 


z 

o 

H 

m 


All values on the stack, including numeric values, are stored as strings. In the preceding 
example, the numeric values 3 and 1 are pushed onto the stack as the strings '' 3" and 

'' 1 . 


The program counter 

The current point of execution of Flash Player is called the program counter (PC). The value 
of the PC is defined as the address of the action that follows the action currently being 
executed. Control flow actions such as Actionjump change the value of the PC. These actions 
are similar to branch instructions in assembler, or the goto instruction in other languages. For 
example, Actionjump tells Flash Player to jump to a new position in the action sequence. The 
new PC is specified as an offset from the current PC. Both positive and negative offsets can 
occur, so Flash Player can jump forward and backward in the action sequence. 


SWF 4 actions 

The following actions are available in SWF 4; 


Type of action 

Name of action 


Arithmetic operators 

ActionAdd 

ActionDivide 

ActionMultiply 

ActionSubtract 


Numerical comparison 

ActionEquals 

ActlonLess 


Logical operators 

ActlonAnd 

ActlonNot 

ActlonOr 
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Type of action 

Name of action 

String manipulation 

ActionStringAdd 

ActionStringEquals 

ActionStringExtract 

ActionStringLength 

ActionMBStringExtract 

ActionMBStringLength 

ActionStringLess 

Stack operations 

ActionPop 

ActionPush 

Type conversion 

ActionAsciiToChar 

ActionCharT oAscii 

ActionToInteger 

ActionMBAsciiToChar 

ActionMBCharToAscii 

Control flow 

ActionCall 

Actionlf 

ActionJump 

Variables 

ActionGetVariable 

ActionSetVariable 

Movie control 

ActionGetURL2 

ActionGetProperty 

ActionGotoFrame2 

ActionRemoveSprite 

ActionSetProperty 

ActionSetT arget2 

ActionStartDrag 

ActionWaitForFrame2 

ActionCloneSprite 

ActionEndDrag 

Utilities 

ActionGetTime 

ActionRandomNumber 

ActionTrace 
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Stack operations 

This section lists stack operations. 


ActionPush 

ActionPush pushes one or more values to the stack. 


Field 

Type 

Comment 

ActionPush 

ACTIONRECORD 

The ActionCode in ACTIONRECORD Is 0x96. 

The Length in ACTIONRECORD represents the 
total number of type and value bytes In this 
ActionPush. 

Type 

UI8 

0 = string literal 

1 = floating-point literal 

The following types are available In Flash 5 and 
later: 

2 = null 

3 = undefined 

4 = register 

5 = Boolean 

6 = double 

7 = integer 

8 = constant 8 

9 = constant 16 

String 

If Type = 0, STRING 

Null-terminated character string 

Float 

If Type = 1, FLOAT 

32-bit IEEE single-precision little-endian floating¬ 
point value 

RegisterNumber 

If Type = 4, UI8 

Register number 

Boolean 

If Type = 5, UI8 

Boolean value 

Double 

If Type = 6, 

64-blt IEEE double-precision little-endian double 


DOUBLE 

value 

Integer 

If Type = 7, UI32 

32-blt little-endian integer 

Constants 

If Type = 8, UI8 

Constant pool Index (for Indexes < 256) (see 
ActlonConstantPool) 

Constant16 

lfType = 9, UI16 

Constant pool index (for indexes >= 256) (see 
ActionConstantPool) 

ActionPush pushes 

one or more values onto the stack. The Type field specifies the type of the 

value to be pushed. 
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If Type = 1, the value to be pushed is specified as a 32-bit IEEE single-precision little-endian 
floating-point value. Propertyids are pushed as FLOATs. ActionGetProperty and 
ActionSetProperty use Propertyids to access the properties of named objects. 

If Type = 4, the value to be pushed is a register number. Flash Player supports up to 4 
registers. With the use of ActionDefmeFunction2, up to 256 registers can be used. 

In the first field of ActionPush, the length in ActionRecord defines the total number of Type 
and value bytes that follow the ACTIONRECORD itself More than one set of Type and 
value fields may follow the first field, depending on the number of bytes that the length in 
ACTIONRECORD specifies. 

ActionPop 

ActionPop pops a value from the stack and discards it. 


Field 

Type 

Comment 


ActionPop 

UI8 

Action = 0x17 



ActionPop pops a value off the stack and discards the value. 


Arithmetic operators 

The following sections describe arithmetic operators. 

ActionAdd 

ActionAdd adds two numbers and pushes the result back to the stack. 


Field 

Type 

Comment 

ActionAdd 

UI8 

Action = OxOA 


ActionAdd does the following: 

1 . Pops value A off the stack. 

2. Pops value B off the stack. 

3 . Converts A and B to floating-point; non-numeric values evaluate to 0. 

4 . Adds the numbers A and B. 

5 . Pushes the result, A+B, to the stack. 


SWF 4 action model 


87 














ActionSubtract 

ActionSubtract subtracts two numbers and pushes the result back to the stack. 


Field 

Type 

Comment 

ActionSubtract 

UI8 

Action = OxOB 


ActionSubtract does the following: 

1 . Pops value A off the stack. 

2. Pops value B off the stack. 

3 . Converts A and B to floating-point; non-numeric values evaluate to 0. 

4 . Subtracts A from B. 

5 . Pushes the result, B-A, to the stack. 


ActionMultiply 

ActionMultiply multiplies two numbers and pushes the result back to the stack. 


Field 

Type 

Comment 

ActionMultiply 

UI8 

Action = OxOC 


ActionMultiply does the following: 

1 . Pops value A off the stack. 

2. Pops value B off the stack. 

3 . Converts A and B to floating-point; non-numeric values evaluate to 0. 

4 . Multiplies A times B. 

5 . Pushes the result, A*B, to the stack. 

ActionDivide 

ActionDivide divides two numbers and pushes the result back to the stack. 


Field 

Type 

Comment 

ActionDivide 

UI8 

Action = OxOD 


88 Actions 



ActionDivide does the following: 

1 . Pops value A off the stack. 

2. Pops value B off the stack. 

3 . Converts A and B to floating-point; non-numeric values evaluate to 0. 

4 . Divides B by A. 

5 . Pushes the result, B/A, to the stack. 

6 . If A is zero, the result NaN, Infinity, or -Infinity is pushed to the stack in SWF 5 and later. 
In SWF 4, the result is the string #ERR0R#. 


Numerical comparison 

ActionEquals 

ActionEquals tests two numbers for equality. 


Field 

Type 

Comment 

ActionEquals 

UI8 

Action = OxOE 


ActionEquals does the following: 

1 . Pops value A off the stack. 

2. Pops value B off the stack. 

3 . Converts A and B to floating-point; non-numeric values evaluate to 0. 

4 . Compares the numbers for equality. 

5 . If the numbers are equal, true is pushed to the stack for SWF 5 and later. 
For SWF 4, 1 is pushed to the stack. 

6 . Otherwise, f al se is pushed to the stack for SWF 5 and later. 

For SWF 4, 0 is pushed to the stack. 

Action Less 

ActionLess tests if a number is less than another number 

Field Type Comment 

ActionLess UI8 Action = OxOF 
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ActionLess does the following: 

1 . Pops value A off the stack. 

2. Pops value B off the stack. 

3 . Converts A and B to floating-point; non-numeric values evaluate to 0. 

4 . If B < A, true is pushed to the stack for SWF 5 and later (1 is pushed for SWF 4); 
otherwise, false is pushed to the stack for SWF 5 and later (0 is pushed for SWF 4). 


Logical operators 

ActionAnd 

ActionAnd performs a logical AND of two numbers. 


Field 

Type 

Comment 

ActionAnd 

UI8 

Action = 0x10 


ActionAdd does the following: 

1 . Pops value A off the stack. 

2. Pops value B off the stack. 

3 . Converts A and B to floating-point; non-numeric values evaluate to 0. 

4 . If both numbers are nonzero, true is pushed to the stack for SWF 5 and later (1 is pushed 
for SWF 4); otherwise, fal se is pushed to the stack for SWF 5 and later (0 is pushed for 
SWF 4). 

ActionOr 

ActionOr performs a logical OR of two numbers. 


Field 

Type 

Comment 

ActionOr 

UI8 

Action = 0x11 
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ActionOr does the following: 

1 . Pops value A off the stack. 

2. Pops value B off the stack. 

3 . Converts A and B to floating-point; non-numeric values evaluate to 0. 

4 . If either of the numbers is nonzero, true is pushed to the stack for SWF 5 and later (1 is 
pushed for SWF 4); otherwise, f a 1 se is pushed to the stack for SWF 5 and later (0 is 
pushed for SWF 4). 

ActionNot 

ActionNot performs a logical NOT of a number. 
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In Flash 5 SWF files, the ActionNot operator converts its argument to a Boolean value, 
and pushes a result of type Boolean. In Flash 4 SWF files, the argument and result are 
numbers. 






Field 

Type 

Comment 

ActionNot 

UI8 

Action = 0x12 

Result 

Boolean 



ActionNot does the following: 

1 . Pops a value off the stack. 

2. Converts the value to floating point; non-numeric values evaluate to 0. 

3 . If the value is zero, true is pushed on the stack for SWF 5 and later (1 is pushed for 
SWF 4). 

4 . If the value is nonzero, f a 1 se is pushed on the stack for SWF 5 and later (0 is pushed for 
SWF 4). 

String manipulation 

ActionStringEquals 

ActionStringEquals tests two strings for equality. 

Field Type Comment 

ActionStringEquals UI8 Action = 0x13 
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ActionStringEquals does the following: 

1. Pops value A off the stack. 

2. Pops value B off the stack. 

3. Compares A and B as strings. 

The comparison is case-sensitive. 

4. If the strings are equal, true is pushed to the stack for SWF 5 and later (SWF 4 pushes 1). 

5. Otherwise, false is pushed to the stack for SWF 5 and later (SWF 4 pushes 0). 

ActionStringLength 

ActionStringLength computes the length of a string. 


Field Type 

Comment 

ActionStringLength UI8 

Action = 0x14 

ActionStringLength does the following: 

1. Pops a string off the stack. 

2. Calculates the length of the string and pushes it to 

the stack. 

Actionstring Add 

ActionStringAdd concatenates two strings. 


Field Type 

Comment 

ActionStringAdd UI8 

Action = 0x21 

ActionStringAdd does the following: 

1. Pops value A off the stack. 

2. Pops value B off the stack. 

3. Pushes the concatenation BA to the stack. 


Act i o n St ri n g Ext ract 

ActionStringFxtract extracts a substring from a string. 


Field Type 

Comment 

ActionStringExtract UI8 

Action = 0x15 
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ActionStringExtract does the following: 

1. Pops number count off the stack. 

2. Pops number i ndex off the stack. 

3. Pops string string off the stack. 

4. Pushes the substring of the string starting at the indexed character and count characters in 
length to the stack. 

5. If either index or count do not evaluate to integers, the result is the empty string. 

ActionStringLess 

ActionStringLess tests to see if a string is less than another string 


Field 

Type 

Comment 

ActionStringLess 

UI8 

Action = 0x29 


ActionStringLess does the following: 

1. Pops value A off the stack. 

2. Pops value B off the stack. 

3. If B < A using a byte-by-byte comparison, true is pushed to the stack for SWF 5 and later 
(SWF 4 pushes 1); otherwise, false is pushed to the stack for SWF 5 and later (SWF 4 
pushes 0). 

ActionMBStringLength 

ActionMBStringLength computes the length of a string and is multi-byte aware. 


Field 

Type 

Comment 

ActionMBStringLength 

UI8 

Action = 0x31 


ActionMBStringLength does the following: 

1. Pops a string off the stack. 

2. Calculates the length of the string in characters and pushes it to the stack. 

This is a multi-byte aware version of ActionStringLength. On systems with double-byte 
support, a double-byte character is counted as a single character. 
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ActionMBStringExtract 

ActionMBStringExtract extracts a substring from a string and is multi-byte aware. 


Field 

Type 

Comment 

ActionMBStringExtract UI8 

Action = 0x35 

It does the following: 

1. Pops the number count off the stack. 

2. Pops the number index off the stack. 

3. Pops the string string off the stack. 

4. Pushes the substring of string starting at 
length to the stack. 

the index’th character and count characters in 
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If either index or count do not evaluate to integers, the result is the empty string. 


This is a multi-byte aware version of ActionStringExtract. Index and count are treated as 
character indexes, counting double-byte characters as single characters. 


Type conversion 

ActionToInteger 


ActionToInteger converts a value to an integer. 


Field 

Type 

Comment 

ActionToInteger 

UI8 

Action = 0x18 


ActionToInteger does the following: 

1. Pops a value off the stack. 

2. Converts the value to a number. 

3. Discards any digits after the decimal point, resulting in an integer. 

4. Pushes the resulting integer to the stack. 
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ActionCharT oAscii 

ActionCharToAscii converts character code to ASCII. 


Field 

Type 

Comment 

ActionCharToAscii 

UI8 

Action = 0x32 


ActionCharToAscii does the following: 

1. Pops a value off the stack. 

2. Converts the first character of the value to a numeric ASCII character code. 

3. Pushes the resulting character code to the stack. 

ActionAsciiT oChar 

ActionAsciiToChar converts a value to an ASCII character code. 


Field 

Type 

Comment 

ActionAsciiToChar 

UI8 

Action = 0x33 


ActionAsciiToChar does the following: 

1. Pops a value off the stack. 

2. Converts the value from a number to the corresponding ASCII character. 

3. Pushes the resulting character to the stack. 

ActionMBCharToAscii 

ActionMBCharToAscii converts character code to ASCII and is multi-byte aware. 


Field 

Type 

Comment 

ActionMBCharToAscii 

UI8 

Action = 0x36 


ActionMBCharToAscii does the following: 

1. Pops a value off the stack. 

2. Converts the first character of the value to a numeric character code. 


If the first character of the value is a double-byte character, a 16-bit value is constructed 
with the first byte as the high-order byte and the second byte as the low-order byte. 

3. Pushes the resulting character code to the stack. 
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ActionMBAsciiToChar 

ActionMBAsdiToChar converts ASCII to character code and is multi-byte aware. 


Field 

Type 

Comment 

ActionMBAsciiToChar 

UI8 

Action = 0x37 


ActionMBAsciiToChar does the following: 

1 . Pops a value off the stack. 

2 . Converts the value from a number to the corresponding character. 

If the character is a 16-bit value (>= 256), a double-byte character is constructed with the 
first byte containing the high-order byte, and the second byte containing the low-order 
byte. 

3 . Pushes the resulting character to the stack. 

Control flow 

ActionJump 


Actionjump creates an 

unconditional branch. 


Field 

Type 

Comment 

Actionjump 

UI8 

Action = 0x99 

BranchOffset 

SI16 



Actionjump adds BranchOffset bytes to the instruction pointer in the execution stream. 

The offset is a signed quantity, enabling branches from —32,768 bytes to 32,767 bytes. An 
offset of 0 points to the action directly after the Actionjump action. 

Actionlf 

Actionlf creates a conditional test and branch. 


Field 

Type 

Comment 

Actionlf 

UI8 

Action = 0x9D 

BranchOffset 

SI16 
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Actionlf does the following: 

1 . Pops Condition, a number, off the stack. 

2. Converts Condi ti on to a Boolean value. 

3. Tests if Condi ti on is true. 

If Condi ti on is true, BranchOffset bytes are added to the instruction pointer in the 
execution stream. 
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When playing a Flash 4 SWF file, Condition is not converted to a Boolean value and 
is instead compared to 0, not true. 


The offset is a signed quantity, enabling branches from -32768 bytes to 32767 bytes. An 
offset of 0 points to the action directly after the Actionlf action. 


ActionCall 

ActionCall calls a subroutine. 


Field 

Type 

Comment 

ActionCall 

UI8 

Action = 0x9E 


ActionCall does the following: 

1 . Pops a value off the stack. 

This value should be either a string that matches a frame label, or a number that indicates 
a frame number. The value can be prefixed by a target string that identifies the movie clip 
that contains the frame being called. 

2. If the frame is successfully located, the actions in the target frame are executed. 

After the actions in the target frame are executed, execution resumes at the instruction 
after the ActionCall instruction. 

3. If the frame cannot be found, nothing happens. 
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Variables 


ActionGetVariable 

ActionGetVariable gets a variable’s value. 


Field 

Type 

Comment 

ActionGetVariable 

UI8 

Action = 0x1C 


ActionGetVariable does the following: 

1. Pops a name off the stack, a string that names is the variable to get. 

2. Pushes the value of the variable to the stack. 

A variable in another execution context can be referenced by prefixing the variable name with 
the target path and a colon. For example: /A/B : FOO references variable FOO in a movie clip 
with a target path of /A/B. 

ActionSetVariable 

ActionSetVariable sets a variable. 


Field 

Type 

Comment 

ActionSetVariable 

UI8 

Action = 0x1 D 


ActionSetVariable does the following: 

1. Pops the value off the stack. 

2. Pops the name off the stack, a string which names the variable to set. 

3. Sets the variable name in the current execution context to value. 

A variable in another execution context can be referenced by prefixing the variable name with 
the target path and a colon. For example: /A/B : FOO references the FOO variable in the movie 
clip with a target path of /A/B. 
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Movie control 


ActionGetURL2 

ActionGetURL2 gets a URL and is stack based. 


Field 

Type 

Comment 

ActionGetURL2 

UI8 

Action = 0x9A 

SendVarsMethod 

UB[2] 

0 = None 

1 = GET 

2 = POST 

Reserved 

UB[4] 

Always 0 

LoadTargetFlag 

UB[1] 

0 = Target is a browser window 

1 = Target is a path to a sprite 

LoadVariablesFlag 

UB[1] 

0 = No variables to load 

1 = Load variables 


ActionGetURL2 does the following: 

1 . Pops target off the stack. 

■ A LoadTargetFlag value of 0 indicates that the target is a window. The target can be an 
empty string to indicate the current window. 

■ A LoadTargetFlag value of 1 indicates that the target is a path to a sprite. The target 
path can be in slash or dot syntax. 

2. Pops a URL off the stack; the URL specifies the URL to be retrieved. 

3. SendVarsMethod specifies the method to use for the IdTTP request. 

■ A SendVarsMethod value of 0 indicates that this is not a form request, so the movie 
clip’s variables should not be encoded and submitted. 

■ A SendVarsMethod value of 1 specifies a HTTP GET request. 

■ A SendVarsMethod value of 2 specifies a HTTP POST request. 

4 . If the SendVarsMethod value is 1 (GET) or 2 (POST), the variables in the current movie 
clip are submitted to the URL by using the standard x-www-form-urlencoded encoding 
and the HTTP request method specified by method. 

If the LoadVariablesFlag is set, the server is expected to respond with a MIME type of 
application/x-www-form-urlencoded and a body in the format 
varl=val uel&var2=val ue2&. . .&varx=val uex. This response is used to populate 
ActionScript variables rather than display a document. The variables populated can be in a 
timeline (if LoadTargetFlag is 0) or in the specified sprite (if LoadTargetFlag is 1). 
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If the LoadTargetFlag is specified without the LoadVariablesFlag, the server is expected to 
respond with a MIME type of application/x-shockwave-flash and a body that consists of a 
SWF file. This response is used to load a subfile into the specified sprite rather than to display 
an HTML document. 


ActionGotoFrame2 

ActionGotoFrame2 goes to a frame and is stack based. 


Field 

ActionGotoFrame2 
Reserved 
SceneBiasFlag 
Play flag 

SceneBlas 


Type 

UI8 

UB[6] 

UB[1] 

UB[1] 

If SceneBiasFlag = 1, UI16 


Comment 

Action = 0x9F 

Always 0 

Scene bias flag 

0 = Go to frame and stop 
1 = Go to frame and play 

Number to be added to frame 
determined by stack argument 


ActionGotoFrame2 does the following: 

1 . Pops a frame off the stack. 

■ If the frame is a number, n, the next frame of the movie to be displayed is the wth 
frame in the current movie clip. 

■ If the frame is a string, frame is treated as a frame label. If the specified label exists in 
the current movie clip, the labeled frame will become the current frame. Otherwise, 
the action is ignored. 

2 . Either a frame or a number can be prefixed by a target path, for example, /MovieClip:3 or 
/MovieGlip:FrameLabel. 

3 . If the Play flag is set, the action goes to the specified frame and begins playing the enclosing 
movie clip. Otherwise, the action goes to the specified frame and stops. 


ActionSetT arget2 

ActionSetTarget2 sets the current context and is stack based. 

Field Type Comment 

ActlonSetTarget2 UI8 Action = 0x20 

ActionSetTarget2 pops the target off the stack and makes it the current active context. 
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This action behaves exactly like ActionSetTarget but is stack based to enable the target path to 
be the result of expression evaluation. 

ActionGetProperty 

ActionGetProperty gets a file property. 


Field 

Type 

Comment 


ActionGetProperty 

UI8 

Action = 0x22 



ActionGetProperty does the following: 

1 . Pops index off the stack. 

2. Pops target off the stack. 

3 . Retrieves the value of the property enumerated as index from the movie clip with target 
path target and pushes the value to the stack. 

The following table lists property index values. The _quality, _xmouse and _ymouse 
properties are available in SWF 5 and later. 


Property 

Value 

_X 

0 

_Y 

1 

_xscale 

2 

_yscale 

3 

_currentframe 

4 

Jotalframes 

5 

_alpha 

6 

_visible 

7 

_width 

8 

_height 

9 

_rotation 

10 

_target 

11 

Jramesloaded 

12 

_name 

13 

_droptarget 

14 

uri 

15 
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Property 

Value 


_highquality 

16 


Jocusrect 

17 


_soundbuftime 

18 


_quality 

19 


_xmouse 

20 


_ymouse 

21 


Act i o n Set P ro pe rty 

ActionSetProperty sets a file 

property. 


Field 

Type 

Comment 

ActionSetProperty 

UI8 

Action = 0x23 


ActionSetProperty does the following: 

1 . Pops a value off the stack. 

2. Pops an index off the stack. 

3 . Pops a target off the stack. 

4 . Sets the property enumerated as index in the movie clip with the target path ta rget to the 
value val ue. 


ActionCloneSprite 

ActionCloneSprite clones a sprite. 


Field 

Type 

Comment 

ActionCloneSprite 

UI8 

Action = 0x24 


ActionCloneSprite does the following: 

1 . Pops a depth off the stack. 

2. Pops a target off the stack. 

3 . Pops a source off the stack. 

4 . Duplicates the movie clip source, giving the new instance the name target, at z-order depth 
depth. 
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ActionRemoveSprite 

ActionRemoveSprite removes a clone sprite. 


Field Type 

Comment 

ActionRemoveSprite UI8 

Action = 0x25 

ActionRemoveSprite does the following: 

1. Pops a target off the stack. 

2. Removes the clone movie clip that the target path ta 

rget identifies. 

ActionStartDrag 

ActionStartDrag starts dragging a movie clip. 


Field Type 

Comment 

ActionStartDrag UI8 

Action = 0x27 


ActionStartDrag does the following: 

1. Pops a target off the stack; target identifies the movie clip to be dragged. 

2. Pops lockcenter off the stack. If lockcenter evaluates to a nonzero value, the center of the 
dragged movie clip is locked to the mouse position. Otherwise, the movie clip moves 
relative to the mouse position when the drag started. 

3. Pops constrain off the stack. 

4. If constrain evaluates to a nonzero value: 

■ Pops y2 off the stack. 

■ Pops x2 off the stack. 

■ Pops yl off the stack. 

■ Pops xl off the stack. 

ActionEndDrag 

ActionEndDrag ends the drag operation in progress, if any. 


Field 

Type 

Comment 

ActionEndDrag 

UI8 

Action = 0x28 
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ActionWaitForFrame2 

ActionWaitForFrame2 waits for a frame to be loaded and is stack based. 


Field 

Type 

Comment 

ActionWaitForFrame2 

UI8 

Action = 0x8D 

SkipCount 

UI8 



ActionWaitForFrame2 does the following: 

1. Pops a frame off the stack. 

2. If the frame is loaded, SkipCount actions that follow the current action are skipped. 

3. The frame is evaluated in the same way as ActionGotoFrame2. 

Utilities 

ActionTrace 

ActionTrace sends a debugging output string. 


Field 

Type 

Comment 


ActionTrace 

UI8 

Action = 0x26 



ActionTrace does the following: 

1. Pops a value off the stack. 

2. In the Test Movie mode of the Macromedia Flash editor, ActionTrace appends a value to 
the output window if the debugging level is not set to None. 

In the Macromedia Flash Player, nothing happens. 
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ActionGetTime 

ActionGetTime reports the milliseconds since the Macromedia Flash Player started. 


Field 

Type 

Comment 

ActionGetTime 

UI8 

Action = 0x34 

ActionGetTime does the following: 

1. Calculates as an integer the number of milliseconds 

2. Pushes the number to the stack. 

since Flash Player was started. 

ActionRandomNumber 

ActionRandomNumber calculates a random number. 


Field 

Type 

Comment 

ActionRandomNumber 

UI8 

Action = 0x30 


ActionRandomNumber does the following: 

1. Pops the maximum off the stack. 

2. Calculates a random number as an integer in the range 0...(maximum-1). 

3. Pushes the random number to the stack. 

SWF 5 action model 

SWF 5 is similar to SWF 4. New actions greatly expand ActionScript functionality. There are 
also new type conversion, math and stack operator actions. 
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SWF 5 actions 

Following is an overview of SWF 5 actions: 


Type of action 

Name of action 

ScriptObject actions 

ActionCallFunction 

ActionCallMethod 

ActionConstantPool 

ActionDefineFunction 

ActionDefineLocal 

ActionDefineLocal2 

ActionDelete 

ActionDelete2 

ActionEnumerate 

ActionEquals2 

ActionGetMember 

ActionInitArray 

ActionInitObject 

ActionNewMethod 

ActionNewObject 

ActionSetMember 

ActionTargetPath 

ActionWith 

Type actions 

ActionToNumber 

ActionToString 

ActionTypeOf 

Math actions 

ActionAdd2 

ActionLess2 

ActionModulo 

Stack operator actions 

ActionBitAnd 

ActionBitLShift 

ActionBitOr 

ActionBitRShift 

ActionBitURShift 

ActionBitXor 

ActionDecrement 

Actionincrement 

ActionPush (Enhancements) 

ActionPushDuplicate 

ActionReturn 

ActionStackSwap 

ActionStoreRegister 
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ScriptObject actions 

ActionCallFunction 

ActionCallFunction executes a function. The function can be an ActionScript built-in 
function (such as parseint), a user-defined ActionScript function, or a native function. For 
more information, see ActionNewObject. 


Field 

Type 

Comment 

ActionCallFunction 

UI8 

Action = 0x3D 


ActionCallFunction does the following: 

1. Pops the function name (String) from the stack. 

2. Pops numArgs (int) from the stack. 

3. Pops the arguments off the stack. 

4. Invokes the function, passing the arguments to it. 

5. Pushes the return value of the function invocation to the stack. 

If no appropriate return value is present (that is, the function does not have a return 
statement), a push undefined message is generated by the compiler and is pushed to the 
stack. The undefined return value should be popped off the stack. 

For all of the call actions (ActionCallMethod, ActionNewMethod, ActionNewObject, and 
ActionCallFunction) and initialization actions (ActionInitObject and ActionInitArray), the 
arguments of the function are pushed onto the stack in reverse order, with the rightmost 
argument first and the leftmost argument last. The arguments are subsequently popped off in 
order (first to last). 

ActionCallMethod 

ActionCallMethod pushes a method (function) call onto the stack, similar to 
ActionNewMethod. 


Field 

Type 

Comment 


ActionCallMethod 

UI8 

Action = 0x52 
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If the named method exists, ActionCallMethod does the following: 

1. Pops the name of the method from the stack. 

If the method name is blank or undefined, the object is taken to be a function object that 
should be invoked, rather than the container object of a method. For example, if 
CallMethod is invoked with object obj and method name blank, it's equivalent to using 
the syntax: 
obj(): 

If a method’s name is foo, it's equivalent to: 

obj.foo(): 

2 . Pops the ScriptObject, object, from the stack. 

3. Pops the number of arguments, args, from the stack. 

4. Pops the arguments off the stack. 

5. Executes the method call with the specified arguments. 

6. Pushes the return value of the method or function to the stack. 

If no appropriate return value is present (the function does not have a return statement), a 
push undefined is generated by the compiler and is pushed to the stack. The undefined 
return value should be popped off the stack. 

For all of the call actions (ActionCallMethod, ActionNewMethod, ActionNewObject, and 
ActionCallFunction) and initialization actions (ActionInitObject and ActionInitArray), the 
arguments of the function are pushed onto the stack in reverse order, with the rightmost 
argument first and the leftmost argument last. The arguments are subsequently popped off in 
order (first to last). 

ActionConstantPool 

ActionConstantPool creates a new constant pool, and replaces the old constant pool if one 
already exists. 


Field 

Type 

Comment 

ActionConstantPool 

UI8 

Action = 0x88 

Count 

UI16 

Number of constants to follow 

ConstantPool 

STRINGjCount] 

String constants 
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ActionDefineFunction 


z 


o 


H 


m 

_1 



ActionDefineFunction is rarely used as of SWF 7 and later; it was superseded by 
ActionDefineFunction2. 


ActionDefineFunction defines a function with a given name and body size. 


Field 

Type 

Comment 

ActionDefineFunction 

UI8 

Action = 0x9B 

FunctionName 

STRING 

Function name, empty if 



anonymous 

NumParams 

UI16 

# of parameters 

param 1 

STRING 

Parameter name 1 

param 2 

STRING 

Parameter name 2 

param N 

STRING 

Parameter name N 

codeSize 

UI16 

# of bytes of code that follow 


ActionDefineFunction parses (in order) FunctionName, NumParams, [paraml, param2, 
param N] and then code size. 

ActionDefineFunction does the following: 

1. Parses the name of the function (name) from the action tag. 

2. Skips the parameters in the tag. 

3. Parses the code size from the tag. 

After the DefineFunction tag, the next codeSize bytes of action data are considered to be 
the body of the function. 

4. Gets the code for the function. 

ActionDefineFunction can be used in the following ways: 

Usage 1 Pushes an anonymous function on the stack that does not persist. This function is 
a function literal that is declared in an expression instead of a statement. An anonymous 
function can be used to define a function, return its value, and assign it to a variable in one 
expression, as in the following ActionScript: 

area = (function () (return Math.PI * radius *radius ;)) (5); 
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Usage 2 Sets a variable with a given FunctionName and a given function definition. This is 
the more conventional function definition. For example, in ActionScript: 

function Circle(radius ) { 

this.radius = radius ; 

this.area = Math.PI * radius * radius: 

) 


ActionDefineLocal 

ActionDefmeLocal defines a local variable and sets its value. If the variable already exists, the 
value is set to the newly specified value. 


Field 

Type 

Comment 

ActionDefineLocal 

UI8 

Action = 0x3C 


ActionDefineLocal does the following: 

1. Pops a value off the stack. 

2. Pops a name off the stack. 

ActionDefineLocal2 


ActionDefineLocal2 defines a local variable without setting its value. If the variable already 
exists, nothing happens. The initial value of the local variable is undef i ned. 


Field 

Type 

Comment 

ActionDefineLocal2 

UI8 

Action = 0x41 

ActionDefineLocal2 

pops name off the stack. 


ActionDelete 



ActionDelete deletes 

a named property from a ScriptObject. 


Field 

Type 

Comment 

ActionDelete 

UI8 

Action = 0x3A 


ActionDelete does the following: 

1. Pops the name of the property to delete off the stack. 

2. Pops the object to delete the property from. 
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ActionDelete2 


ActionDelete2 deletes a named property. Flash Player first looks for the property in the 
current scope, and if the property cannot be found, continues to search in the encompassing 
scopes. 


Field 

Type 

Comment 

ActionDelete2 

UI8 

Action = 0x3B 


ActionDelete2 pops the name of the property to delete off the stack. 


ActionEnumerate 


ActionEnumerate obtains the names of all “slots” in use in an ActionScript object—that is, for 
an object obj, all names X that could be retrieved with the syntax obj . X. ActionEnumerate is 
used to implement the f or. .in statement in ActionScript. 
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Certain special slot names are omitted; fora list of these, search for the term DontEnum in 
the ECMA-262 standard. 


Field Type Comment 

ActionEnumerate UI8 Action = 0x46 


ActionEnumerate does the following: 

1. Pops the name of the object variable (which can include slash-path or dot-path syntax) off 
of the stack. 

2. Pushes a null value onto the stack to indicate the end of the slot names. 

3. Pushes each slot name (a string) onto the stack. 
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The order in which slot names are pushed is undefined. 


ActionEquals2 

ActionEquals2 is similar to ActionEquals, but ActionEquals2 knows about types. The equality 
comparison algorithm from ECMA-262 Section 11.9.3 is applied. 

Field Type Comment 

ActionEquals2 UI8 Action = 0x49 
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ActionEquals2 does the following: 

1. Pops argl off the stack. 

2. Pops arg2 off the stack. 

3. Pushes the return value to the stack. 


ActionGetMember 

ActionGetMember retrieves a named property from an object, and pushes the value of the 
property onto the stack. 


Field 

Type 

Comment 

ActionGetMember 

UI8 

Action = 0x4E 


ActionGetMember does the following: 

1. Pops the name of the member function. 

2. Pops the ScriptObject object off of the stack. 

3. Pushes the value of the property on to the stack. 

For example, assume ob j is an object, and it is assigned a property, f oo, as follows: 
obj.foo = 3; 

Then, ActionGetMember with object set to obj and name set to foo pushes 3 onto the stack. 
If the specified property does not exist, undef i ned is pushed to the stack. 

The object parameter cannot actually be of type Object. If the object parameter is a primitive 
type such as number. Boolean, or string, it is converted automatically to a temporary wrapper 
object of class Number, Boolean, or String. Thus, methods of wrapper objects can be invoked 
on values of primitive types. For example, the following correctly prints 5: 

var X = "Hel1o": 
trace (x.1ength); 

In this case, the variable, x, contains the primitive string, "Hello". When x. 1 ength is 
retrieved, a temporary wrapper object for x is created by using the String type, which has a 
length property. 
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ActionInitArray 

ActionInitArray initializes an array in a ScriptObject and is similar to ActionInitObject. The 
newly created object is pushed to the stack. The stack is the only existing reference to the 
newly created object. A subsequent SetVariable or SetMember action can store the newly 
created object in a variable. 


Field 

Type 

Comment 


ActionInitArray 

UI8 

Action = 0x42 



ActionInitArray pops elems and then [a rgl, arg2, .... a rgn] off the stack. 
ActionInitArray does the following: 

1. Gets the number of arguments (or elements) from the stack. 

2. If arguments are present, ActionInitArray initializes an array object with the right number 
of elements. 

3. Initializes the array as a ScriptObject. 

4. Sets the object type to Array. 

5. Populates the array with initial elements by popping the values off of the stack. 

For all of the call actions (ActionCallMethod, ActionNewMethod, ActionNewObject, and 
ActionCallFunction) and initialization actions (ActionInitObject and ActionInitArray), the 
arguments of the function are pushed onto the stack in reverse order, with the rightmost 
argument first and the leftmost argument last. The arguments are subsequently popped off in 
order (first to last). 

ActionInitObject 

ActionInitObject initializes an object and is similar to ActionInitArray. The newly created 
object is pushed to the stack. The stack is the only existing reference to the newly created 
object. A subsequent SetVariable or SetMember action can store the newly created object in a 
variable. 


Field 

Type 

Comment 

ActionInitObject 

UI8 

Action = 0x43 


ActionInitObject pops el ems off of the stack. Pops [val uel, namel, .... valueN, nameN] 
off the stack. 
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ActionInitObject does the following: 

1. Pops the number of initial properties from the stack. 

2. Initializes the object as a ScriptObject. 

3. Sets the object type to Obj ect. 

4. Pops each initial property off the stack. 

For each initial property, the value of the property is popped off the stack, then the name 
of the property is popped off the stack. The name of the property is converted to a string. 
The value can be of any type. 

For all of the call actions (ActionCallMethod, ActionNewMethod, ActionNewObject, and 
ActionCallFunction) and initialization actions (ActionInitObject and ActionInitArray), the 
arguments of the function are pushed onto the stack in reverse order, with the rightmost 
argument first and the leftmost argument last. The arguments are subsequently popped off in 
order (first to last). 

ActionNewMethod 

ActionNewMethod invokes a constructor function to create a new object. A new object is 
constructed and passed to the constructor function as the value of the this keyword. 
Arguments can be specified to the constructor function. The return value from the 
constructor function is discarded. The newly constructed object is pushed to the stack, similar 
to ActionCallMethod and ActionNewObject. 


Field 

Type 

Comment 


ActionNewMethod 

UI8 

Action = 0x53 



ActionNewMethod does the following: 

1. Pops the name of the method from the stack. 

2. Pops the ScriptOhject from the stack. 

If the name of the method is blank, the ScriptObject is treated as a function object that is 
invoked as the constructor function. If the method name is not blank, the named method 
of the ScriptObject is invoked. 

3. Pops the number of arguments from the stack. 

4. Executes the method call. 

5. Pushes the newly constructed object to the stack. 

If no appropriate return value occurs (for instance, the function does not have a return 
statement), the compiler generates a push undefined and pushes it to the stack. The 
undefined return value should be popped off the stack. 
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For all of the call actions (ActionCallMethod, ActionNewMethod, ActionNewObject, and 
ActionCallFunction) and initialization actions (ActionInitObject and ActionInitArray), the 
arguments of the function are pushed onto the stack in reverse order, with the rightmost 
argument first and the leftmost argument last. The arguments are subsequently popped off in 
order (first to last). 

ActionNewObject 

ActionNewObject invokes a constructor function. A new object is created and passed to the 
constructor function as the this keyword. In addition, arguments can optionally be specified 
to the constructor function on the stack. The return value of the constructor function is 
discarded. The newly constructed object is pushed to the stack. ActionNewObject is similar 
to ActionCallFunction and ActionNewMethod. 


Field 

Type 

Comment 

ActionNewObject 

UI8 

Action = 0x40 


ActionNewObject does the following: 

1. Pops the object name (STRING) this from the stack. 

2. Pops numArgs (int) from the stack. 

3. Pops the arguments off the stack. 

4. Invokes the named object as a constructor function, passing it the specified arguments and 
a newly constructed object as the this keyword. 

5. The return value of the constructor function is discarded. 

6. The newly constructed object is pushed to the stack. 

For all of the call actions (ActionCallMethod, ActionNewMethod, ActionNewObject, and 
ActionCallFunction) and initialization actions (ActionInitObject and ActionInitArray), the 
arguments of the function are pushed onto the stack in reverse order, with the rightmost 
argument first and the leftmost argument last. The arguments are subsequently popped off in 
order (first to last). 

ActionSetMember 

ActionSetMember sets a property of an object. If the property does not already exist, it is 
created. Any existing value in the property is overwritten. 


Field 

Type 

Comment 

ActionSetMember 

UI8 

Action = 0x4F 
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ActionSetMember does the following: 

1. Pops the new value off the stack. 

2. Pops the object name off the stack. 

3. Pops the object off of the stack. 

ActionT argetPath 

If the object in the stack is of type Movi eCl i p, the object’s target path is pushed on the stack 
in dot notation. If the object is not a Movi eCl i p, the result is undef i ned rather than the 
movie clip target path. 


Field 

Type 

Comment 

ActionTargetPath 

UI8 

Action = 0x45 


ActionTargetPath does the following: 

1. Pops the object off the stack. 

2. Pushes the target path onto the stack. 

ActionWith 

Defines a With block of script. 


Field 

Type 

Comment 

ActionWith 

UI8 

Action = 0x94 

Size 

UI16 

# of bytes of code that follow 


ActionWith does the following: 

1. Pops the object involved with the With. 

2. Parses the size (body length) of the With block from the ActionWith tag. 

3. Checks to see if the depth of calls exceeds the maximum depth, which is 16 for SWF 6 and 
later, and 8 for SWF 5. 

If the With depth exceeds the maximum depth, the next Size bytes of data are skipped 
rather than executed. 

4. After the ActionWith tag, the next Size bytes of action codes are considered to be the body 
of the With block. 

5. Adds the With block to the scope chain. 
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Type actions 

ActionToNumber 

Converts the object on the top of the stack into a number, and pushes the number back to 
the stack. 

For the Object type, the ActionScript val ueOf () method is invoked to convert the object to 
a Number type for ActionToNumber. Conversions between primitive types, such as from 
Stri ng to Number, are built-in. 


Field 

Type 

Comment 

ActionToNumber 

UI8 

Action = 0x4A 


ActionToNumber does the following: 

1. Pops the object off of the stack. 

2. Pushes the number on to the stack. 


ActionToString 

ActionToString converts the object on the top of the stack into a String, and pushes the 
string back to the stack. 

For the Object type, the ActionScript toStri ng( ) method is invoked to convert the object 
to the String type for ActionToString. 


Field 

Type 

Comment 

ActionToString 

UI8 

Action = 0x4B 


ActionToString does the following: 

1. Pops the object off of the stack. 

2. Pushes the string on to the stack. 
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ActionTypeOf 

ActionTypeOf pushes the object type to the stack, which is equivalent to the ActionScript 
TypeOf () method. The possible types are: 

“number” 

“boolean” 

“string” 

“obj ect” 

“movieelip” 

“null” 

“undefined” 

“function” 


Field 

Type 

Comment 


ActionTypeOf 

UI8 

Action = 0x44 



ActionTypeOf does the following: 

1. Pops the value to determine the type of off the stack. 

2. Pushes a string with the type of the object on to the stack. 


Math actions 

ActionAdd2 

ActionAdd2 is similar to ActionAdd, but performs the addition differently, according to the 
data types of the arguments. The addition operator algorithm in ECMA-262 Section 11.6.1 is 
used. If string concatenation is applied, the concatenated string is arg2 followed by argl. 


Field 

Type 

Comment 


ActionAdd2 

UI8 

Action = 0x47 



ActionAdd2 does the following: 

1. Pops argl off of the stack. 

2. Pops arg2 off of the stack. 

3. Pushes the result back to the stack. 
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Action Less2 


ActionLess2 calculates whether argl is less than arg2 and pushes a Boolean return value to the 
stack. This action is similar to ActionLess, but performs the comparison differently according 
to the data types of the arguments. The abstract relational comparison algorithm in ECMA- 
262 Section 11.8.5 is used. 


Field 

Type 

Comment 

ActionLess2 

UI8 

Action = 0x48 


ActionLess2 does the following: 

1. Pops argl off of the stack. 

2. Pops arg2 off of the stack. 

3. Compares arg2 < argl. 

4. Pushes the return value (a Boolean value) onto the stack. 

ActionModulo 

ActionModulo calculates x modulo j. Ify is 0, then NaN (0x7FC00000) is pushed to the 
stack. 


Field 

Type 

Comment 

ActionModulo 

UI8 

Action = 0x3F 


ActionModulo does the following: 

1. Pops x then j off of the stack. 

2. Pushes the value x % y on to the stack. 


Stack operator actions 

ActionBitAnd 

ActionBitAnd pops two numbers off of the stack, performs a bitwise AND, and pushes an 
S32 number to the stack. The arguments are converted to 32-bit unsigned integers before 
performing the bitwise operation. The result is a SIGNED 32-bit integer. 

Field Type Comment 

ActionBitAnd UI8 Action = 0x60 
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ActionBitAnd does the following: 

1. Pops argl then arg2 off of the stack. 

2. Pushes the result to the stack. 

ActionBitLShift 

ActionBitLShift pops the shift count a r g and then value off of the stack. The value argument 
is converted to 32-bit signed integer and only the least significant 5 bits are used as the shift 
count. The bits in the value a rg are shifted to the left by the shift count. ActionBitLShift 
pushes an S32 number to the stack. 


Field 

Type 

Comment 

ActionBitLShift 

UI8 

Action = 0x63 


ActionBitLShift does the following: 

1. Pops shift count arg, then val ue off of the stack. 

2. Pushes the result to the stack. 


ActionBitOr 

ActionBitOr pops two numbers off of the stack, performs a bitwise OR, and pushes an S32 
number to the stack. The arguments are converted to 32-bit unsigned integers before 
performing the bitwise operation. The result is a SIGNED 32-bit integer. 


Field 

Type 

Comment 

ActionBitOr 

UI8 

Action = 0x61 


ActionBitOr does the following: 

1. Pops argl then arg2 off of the stack. 

2. Pushes the result to the stack. 
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ActionBitRShift 


ActionBitRShift pops the shift count from the stack. Pops the value from the stack. The value 
argument is converted to a 32-bit signed integer and only the least significant 5 bits are used 
as the shift count. 

The bits in the a rg value are shifted to the right by the shift count. ActionBitRShift pushes an 
S32 number to the stack. 


Field 

Type 

Comment 

ActionBitRShift 

UI8 

Action = 0x64 


ActionBitRShift does the following: 

1. Pops the shift count from the stack. 

2. Pops the value to shift from the stack. 

3. Pushes the result to the stack. 

ActionBitURShift 

ActionBitURShift pops the value and shift count arguments from the stack. The value 
argument is converted to 32-bit signed integer and only the least significant 5 bits are used as 
the shift count. 

The bits in the a rg value are shifted to the right by the shift count. ActionBitURShift pushes 
a UI32 number to the stack. 


Field 

Type 

Comment 

ActionBitURShift 

UI8 

Action = 0x65 


ActionBitURShift does the following: 

1. Pops the shift count from the stack. 

2. Pops the value to shift from the stack. 

3. Pushes the result to the stack. 
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ActionBitXor 


ActionBitXor pops two numbers off of the stack, performs a bitwise XOR, and pushes an S32 
number to the stack. 

The arguments are converted to 32-bit unsigned integers before performing the bitwise 
operation. The result is a SIGNED 32-bit integer. 


Field 

Type 

Comment 

ActionBitXor 

UI8 

Action = 0x62 


ActionBitXor does the following: 

1. Pops argl and arg2 off of the stack. 

2. Pushes the result back to the stack. 

ActionDecrement 

ActionDecrement pops a value from the stack, converts it to number type, decrements it by 1, 
and pushes it back to the stack. 


Field 

Type 

Comment 

ActionDecrement 

UI8 

Action = 0x51 


ActionDecrement does the following: 

1. Pops the number off of the stack. 

2. Pushes the result on to the stack. 

Actionincrement 

Actionincrement pops a value from the stack, converts it to number type, increments it by 1, 
and pushes it back to the stack. 


Field 

Type 

Comment 

Actionincrement 

UI8 

Action = 0x50 


Actionincrement does the following: 

1. Pops the number off of the stack. 

2. Pushes the result on to the stack. 
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ActionPush (Enhancements) 

With Flash 5, eight new types were added to ActionPush. For more on ActionPush, see the 
SWF 4 actions. 

ActionPushDuplicate 

ActionPushDuplicate pushes a duplicate of top of stack (the current return value) to the stack. 


Field 

Type 

Comment 

ActionPushDuplicate 

UI8 

Action = 0x4C 

ActionReturn 



ActionReturn forces the return item to be pushed off the stack and returned. If a return is not 
appropriate, the return item is discarded. 

Field 

Type 

Comment 

ActionReturn 

UI8 

Action = 0x3E 


ActionReturn pops a value off the stack. 

ActionStackSwap 

ActionStackSwap swaps the top two ScriptAtoms on the stack. 


Field 

Type 

Comment 


ActionStackSwap 

UI8 

Action = 0x4D 



ActionStackSwap does the following: 

1. Pops Iteml and then Item2 off of the stack. 

2. Pushes Item2 and then Iteml back to the stack. 


ActionStoreRegister 

ActionStoreRegister reads the next object from the stack (without popping it) and stores it in 
one of four registers. If ActionDefmeFunction2 is used, up to 256 registers are available. 


Field 

Type 

Comment 


ActionStoreRegister 

UI8 

Action = 0x87 


RegisterNumber 

UI8 
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ActionStoreRegister parses register number from the StoreRegister tag. 


SWF 6 action model 

SWF 6 adds the DoInitAction action-definition tag, and a few new action bytecodes. 

SWF 6 actions 

The following actions are available in SWF 6: 

■ DoInitAction 

■ ActionInstanceOf 

■ ActionEnumerate2 

■ ActionStrictEquals 

■ ActionGreater 

■ ActionStringGreater 

DoInitAction 

The DoInitAction tag is similar to the DoAction tag: it defines a series of bytecodes to be 
executed. However, the actions defined with DoInitAction are executed earlier than the usual 
DoAction actions, and are executed only once. 

In some situations, actions must be executed before the ActionScript representation of the first 
instance of a particular sprite is created. The most common such action is calling 
Object.registerClass to associate an ActionScript class with a sprite. Such a call is generally 
found within the #initclip pragma in the ActionScript language. DoInitAction is used to 
implement the #initclip pragma. 

A DoInitAction tag specifies a particular sprite to which its actions apply. A single frame can 
contain multiple DoInitAction tags; their actions are executed in the order in which the tags 
appear. However, the SWF file can contain only one DoInitAction tag for any particular 
sprite. 
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The specified actions are executed immediately before the normal actions of the frame in 
which the DoInitAction tag appears. This only occurs the first time that this frame is 
encountered; playback reaches the same frame again later, actions provided in DoInitAction 
are skipped. 
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Specifying actions at the beginning of a DoAction tag is not the same as specifying them 
in a DoInitAction tag. Flash Player takes steps before the first action in a DoAction tag, 
most relevantly the creation of ActlonScrIpt objects that represent sprites. The actions in 
DoInitAction occur before these implicit steps are performed. 


Field 

Header 
Sprite ID 
Actions 
ActionEndFlag 


Type 

RECORDHEADER 

UI16 

ACTIONRECORD[zero or more] 
UI8 


Comment 

Tag type = 59 

Sprite to which these actions apply 
List of actions to perform 
Always set to 0 


ActionInstanceOf 

ActionInstanceOf implements the ActionScript instanceoff ) operator. This is a Boolean 
operator that indicates whether the left operand (typically an object) is an instance of the class 
represented by a constructor function passed as the right operand. 

Additionally, with SWF 7 or later, ActionInstanceOf also supports with interfaces. If the right 
operand constructor is a reference to an interface object, and the left operand implements this 
interface, ActionInstanceOf accurately reports that the left operand is an instance of the right 
operand. 


Field 

Type 

Comment 

ActionInstanceOf 

UI8 

Action = 0x54 

ActionInstanceOf does the following: 

1. Pops constr then obj off of the stack. 



2. Determines if obj is an instance of constr. 

3. Pushes the return value (a Boolean value) onto the stack. 
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ActionEnumerate2 


ActionEnumerate2 is similar to ActionEnumerate, but uses a stack argument of object type 
rather than using a string to specify its name. 


Field 

Type 

Comment 

ActionEnumerate2 

UI8 

Action = 0x55 


ActionEnumerate2 does the following: 

1. Pops obj off of the stack. 

2. Pushes a null value onto the stack to indicate the end of the slot names. 

3. Pushes each slot name (a string) from obj onto the stack. 
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The order in which slot names are pushed is undefined. 


ActionStrictEquals 

ActionStrictEquals is similar to ActionEquals2, but the two arguments must be of the same 
type in order to be considered equal. Implements the “===’ operator from the ActionScript 
language. 


Field 

Type 

Comment 

ActionStrictEquals 

UI8 

Action = 0x66 


ActionStrictEquals does the following: 

1. Pops argl then arg2 off the stack. 

2. Pushes the return value, a Boolean value, to the stack. 

ActionGreater 

ActionGreater is the exact opposite of ActionLess2. Originally there was no ActionGreater, 
because it can be emulated by reversing the order of argument pushing, then performing an 
ActionLess followed by an ActionNot. However, this argument reversal resulted in a reversal 
of the usual order of evaluation of arguments, which in a few cases led to surprises. 

Field Type Comment 

ActionGreater UI8 Action = 0x67 
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ActionGreater does the following: 

1. Pops argl and then arg2 off of the stack. 

2. Compares if arg2 > argl. 

3. Pushes the return value, a Boolean value, onto the stack. 


ActionStringGreater 

ActionStringGreater is the exact opposite of ActionStringLess. This action code was added for 
the same reasons as ActionGreater. 


Field 

Type 

Comment 


ActionStringGreater 

UI8 

Action = 0x68 



ActionStringGreater does the following: 

1. Pops argl and then arg2 off of the stack. 

2. Compares if arg2 > argl, using byte-by-byte comparison. 

3. Pushes the return value, a Boolean value, onto the stack. 

SWF 7 action model 

SWF 7 actions 

The following actions are available in SWF 7: 

■ ActionDefineFunction2 

■ ActionExtends 

■ ActionCastOp 

■ ActionImplementsOp 

■ ActionTry 

■ ActionTbrow 
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ActionDefineFunction2 


ActionDefmeFunction2 is similar to ActionDefineFunction, with additional features that can 
help speed up the execution of function calls by preventing the creation of unused variables in 
the function’s activation object and by enabling the replacement of local variables with a 
variable number of registers. With ActionDefmeFunction2, a function can allocate its own 
private set of up to 256 registers. Parameters or local variables can be replaced with a register, 
which is loaded with the value instead of the value being stored in the function’s activation 
object. (The activation object is an implicit local scope that contains named arguments and 
local variables. For further description of the activation object, see the ECMA-262 standard.) 

ActionDefmeFunction2 also includes six flags to instruct Flash Player to preload variables, 
and three flags to suppress variables. By setting Prel oadParentFl ag, Prel oadRootFl ag , 
Prel oadSuperFl ag, Prel oadArgumentsFl ag, Prel oadThi sFl ag, or 
PreloadGlobalFlag, common variables can be preloaded into registers before the function 
executes {_parent, _root, super, arguments, this, or _global, respectively). With flags 
SuppressSuper, SuppressArguments, and SuppressThi s, common variables super, 
arguments, and this are not created. By using suppress flags. Flash Player avoids pre¬ 
evaluating variables, thus saving time and improving performance. 

No suppress flags are provided for _pa rent, _root, or_global because Flash Player always 
evaluates these variables as needed; no time is ever wasted on pre-evaluating these variables. 

Specifying both the preload flag and the suppress flag for any variable is not allowed. 

The body of the function that ActionDefmeFunction2 specifies should use ActionPush and 
ActionStoreRegister for local variables that are assigned to registers. ActionGetVariable and 
ActionSetVariable cannot be used for variables assigned to registers. 

Flash Player 6 release 65 and later supports ActionDefineFunction2. 


Field 

Type 

Comment 

ActionDefineFunction2 

UI8 

Action = 0x8E 

FunctionName 

STRING 

Name of function, empty if 
anonymous 

NumParams 

UI16 

# of parameters 

RegisterCount 

UI8 

Number of registers to 
allocate, up to 255 registers 
(from 0 to 254) 

PreloadParentFlag 

UB[1] 

0 = Don’t preload _parent 
into register 

1 = Preload _parent into 
register 
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Field 

Type 

Comment 

PreloadRootFlag 

UB[1] 

0 = Don’t preload _root into 
register 

1 = Preload _root into 
register 

SuppressSuperFlag 

UB[1] 

0 = Create super variable 

1 = Don’t create super 
variable 

PreloadSuperFlag 

UB[1] 

0 = Don’t preload super into 
register 

1 = Preload super into 
register 

SuppressArgumentsFlag 

UB[1] 

0 = Create arguments 
variable 

1 = Don’t create arguments 
variable 

PreloadArgumentsFlag 

UB[1] 

0 = Don’t preload arguments 
into register 

1 = Preload arguments into 
register 

SuppressThisFlag 

UB[1] 

0 = Create this variable 

1 = Don’t create this variable 

PreloadThisFlag 

UB[1] 

0 = Don’t preload this into 
register 

1 = Preload thi s into register 

Reserved 

UB[7] 

Always 0 

PreloadGlobalFlag 

UB[1] 

0 = Don’t preload _gl obal 
into register 

1 = Preload _gl obal into 
register 

Parameters 

REGISTERPARAM[NumParams] 

See REGISTERPARAM, 
following 

codeSize 

UI16 

# of bytes of code that follow 
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REGISTERPARAM is defined as follows: 


Field Type Comment 

Register UI8 For each parameter to the function, 

a register can be specified. 

If the register specified is zero, the 
parameter is created as a variable 
named ParamName in the activation 
object, which can be referenced with 
ActionGetVariable and 
ActionSetVariable. 

If the register specified is nonzero, 
the parameter is copied into the 
register, and it can be referenced 
with ActionPush and 
ActionStoreRegister, and no 
variable is created in the activation 
object. 

ParamName STRING Parameter name 

The function body following an ActionDefineFunction2 consists of further action codes, just 
as for ActionDefineFunction. 

Flash Player selects register numbers by first copying each argument into the register specified 
in the corresponding REGISTERPARAM record. Next, the preloaded variables are copied 
into registers starting at 1 , and in the order t h i s , arguments, super, _root, _parent, 
and _gl obal , skipping any that are not to be preloaded. (The SWF file must accurately 
specify which registers will be used by preloaded variables and ensure that no parameter uses a 
register number that falls within this range, or else that parameter is overwritten by a 
preloaded variable.) 

The value of NumParams should equal the number of parameter registers. The value of 
RegisterCount should equal NumParams plus the number of preloaded variables and the 
number of local variable registers desired. 

For example, if NumParams is 2, RegisterCount is 6, PreloadThisFlag is 1, and 
PreloadRootFlag is 1, the REGISTERPARAM records will probably specify registers 3 and 4. 
Register 1 will be t hi s , register 2 will be _root, registers 3 and 4 will be the first and second 
parameters, and registers 5 and 6 will be for local variables. 
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ActionExtends 


ActionExtends implements the ActionScript extends keyword. ActionExtends creates an 
inheritance relationship between two classes, called the subclass and the superclass. 

SWF 7 adds ActionExtends to the file format to avoid spurious calls to the superclass 
constructor function (which would occur when inheritance was established under 
ActionScript 1.0). Consider the following code: 

Subclass.prototype = new Superclass(); 

Before the existence of ActionExtends, this code would result in a spurious call to the 
Supercl ass superconstructor function. Now, ActionExtends is generated by the 
ActionScript compiler when the code c 1 ass A extends B is encountered, to set up the 
inheritance relationship between A and B. 


Field 

Type 

Comment 

ActionExtends 

UI8 

Action = 0x69 


ActionExtends does the following: 

1. Pops the ScriptObject superclass constructor off the stack. 

2. Pops the ScriptObject subclass constructor off the stack. 

3. Creates a new ScriptObject. 

4. Sets the new ScriptObject’s_ proto _property to the superclass’ prototype property. 

5. Sets the new ScriptObject’s_ constructor _property to the superclass. 

6. Sets the subclass’ prototype property to the new ScriptObject. 

These steps are the equivalent to the following ActionScript: 

Subclass.prototype = new Object!); 

Subclass.prototype._proto_ = Superclass.prototype; 

Subclass.prototype._constructor_ = Superclass: 

ActionCastOp 

ActionCastOp implements the ActionScript cast operator, which allows the casting from one 
data type to another. ActionCastOp pops an object off the stack and attempts to convert the 
object to an instance of the class or to the interface represented by the constructor function. 

Field Type Comment 

ActionCastOp UI8 Action = 0x2B 
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ActionCastOp does the following: 

1. Pops the ScriptObject to cast off the stack. 

2 . Pops the constructor function off the stack. 

3. Determines if object is an instance of constructor (doing the same comparison as 
ActionInstanceOf). 

4. If the object is an instance of constructor, the popped ScriptObject is pushed onto the 
stack. 

If the object is not an instance of constructor, a null value is pushed onto the stack. 

ActionImplementsOp 

ActionImplementsOp implements the ActionScript implements keyword. The 
ActionImplementsOp action specifies the interfaces that a class implements, for use by 
ActionCastOp. ActionImplementsOp can also specify the interfaces that an interface 
implements, as interfaces can extend other interfaces. 


Field 

Type 

Comment 

ActionImplementsOp 

UI8 

Action = 0x2C 


ActionImplementsOp does the following: 

1. Pops the constructor function off the stack. 

The constructor function represents the class that will implement the interfaces. The 
constructor function must have a prototype property. 

2 . Pops the count of implemented interfaces off the stack. 

3. For each interface count, pops a constructor function off of the stack. 

The constructor function represents an interface. 

4. Sets the constructor function’s list of interfaces to the array collected in the previous step, 
and sets the count of interfaces to the count popped in step 2. 
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ActionTry 

ActionTry defines handlers for exceptional conditions, implementing the ActionScript t ry, 
catch, and fi nal ly keywords. 


Field 

Type 

Comment 

ActionTry 

UI8 

Action = 0x8F 

Reserved 

UB[5] 

Always zero 

CatchlnRegisterFlag 

UB[1] 

0 - Do not put caught object 
into register (instead, store in 
named variable) 

1 - Put caught object into 
register (do not store in named 
variable) 

FinallyBlockFlag 

UB[1] 

0 - No finally block 

1 - Has finally block 

CatchBlockFlag 

UB[1] 

0 - No catch block 

1 - Has catch block 

TrySize 

UI16 

Length of the try block 

CatchSize 

UI16 

Length of the catch block 

FinallySize 

UI16 

Length of the finally block 

CatchName 

If CatchlnRegisterFlag = 0, 
STRING 

Name of the catch variable 

CatchRegister 

If CatchlnRegisterFlag = 1, UI8 

Register to catch into 

TryBody 

UI8[TrySize] 

Body of the try block 

CatchBody 

UI8[CatchSize] 

Body of the catch block, if any 

FinallyBody 

UI8[FinallySize] 

Body of the finally block, if any 
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The CatchSize and FinallySize fields always exist, whether or not the CatchBlockFlag or 
FinallyBlockFlag settings are 1. 
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The try, catch, and finally blocks do not use end tags to mark the end of their respective 
blocks. Instead, the length of a block is set by the TrySize, CatchSize, and FinallySize 
values. 
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ActionThrow 


ActionThrow implements the ActionScript throw keyword. ActionThrow is used to signal, or 
throw, an exceptional condition, which is handled by the exception handlers declared with 
ActionTry. 

If any code within the try block throws an object, control passes to the catch block, if one 
exists, then to the finally block, if one exists. The finally block always executes, regardless 
of whether an error was thrown. 

If an exceptional condition occurs within a function and the function does not include a 
catch handler, the function and any caller functions are exited until a catch block is found 
(executing all f i n a 11 y handlers at all levels). 

Any ActionScript data type can be thrown, though typically usage is to throw objects. 


Field 

Type 

Comment 

ActionThrow 

UI8 

Action = 0x2A 

ActionThrow pops 

the value to be thrown off the stack. 
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CHAPTER 8 


8 


Shapes 


The Macromedia Flash (SWF) shape architecture is designed to be compact, flexible and 
rendered very quickly to the screen. It is similar to most vector formats in that shapes are 
defined by a list of edges called a path. A path may be closed, where the start and end of the 
path meet to close the figure, or open, where the path forms an open-ended stroke. A path 
may contain a mixture of straight edges, curved edges, and ‘pen up and move’ commands. 
The latter allows multiple disconnected figures to be described by a single shape structure. 

A fill style defines the appearance of an area enclosed by a path. Fill styles supported by the 
SWF file format include a color, a gradient, or a bitmap image. 

A line style defines the appearance of the outline of a path. The line style may be a stroke of 
any thickness and color. 

Most vector formats allow only one fill and line style per path. The SWF file format extends 
this concept by allowing each edge to have its own line and fill style. This can have 
unpredictable results when fill styles change in the middle of a path. 

Flash also supports two fill styles per edge, one for each side of the edge: FillStyleO and 
FillStylel. FillStyleO should always be used first and then FillStylel if the shape is filled on 
both sides of the edge. 

Shape overview 

A shape is composed of the following elements: 

Characterld A 16-bit value that uniquely identifies this shape as a ‘character’ in the 
dictionary. The Characterld can be referred to in control tags such as PlaceObject. Characters 
can be reused and combined with other characters to make more complex shapes. 

Bounding box The rectangle that completely encloses the shape. 

Fill style array A list of all the fill styles used in a shape. 

Line style array A list of all the line styles used in a shape. 
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Shape record array A list of shape records. Shape records can define straight or curved 
edges, style changes, or move the drawing position. 
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Line and fill styles are defined only once and may be used (and reused) by any of the 
edges in the shape. 


Shape example 

The following example appears to be a collection of shapes, but it can be described with a 
single DefmeShape tag. 



The red circle, red square and green rounded-rectangle are closed paths. The curved line is an 
open path. The red square consists of all straight edges, the red circle consists of all curved 
edges, while the rounded rectangle has curved edges interspersed with straight edges. 

There are two fill styles, solid green and solid red, and two line styles, 1-pixel black, and 2- 
pixel black. The red circle and red square share the same fill and line styles. The rounded 
rectangle and curved line share the same line style. 

Here’s how to describe this example with the SWF file format. 

Define the fill styles: 

1. First, the fill styles are defined with a FILLSTYLliARRAY. The two unique fill styles are 
solid red and solid green. 

2. This is followed by a LINESTYLEARRAY that includes the two unique line styles; 1-pixel 
black, and 2-pixel black. 

3. This is followed by an array of shape records (see Shape records). 


136 Shapes 









All shape records share a similar structure but can have varied meaning. A shape record can 

define straight or curved edge, a style change, or it can move the current drawing position. 

Define the curved line: 

1 . The first shape record selects the 2-pixel-wide line style, and moves the drawing position 
to the top of the curved line by setting the StateMoveTo flag. 

2. The next shape record is a curved edge, which ends to the bottom of the line. The path is 
not closed. 

Define the red square: 

1 . The next shape record selects the 1-pixel line style and the red fill style. It also moves the 
drawing position to the upper-left corner of the red rectangle. 

2. The following four shape records are straight edges. The last edge must end at the upper- 
left corner. Flash requires that closed figures be joined explicitly. That is, the first and last 
points must be coincident. 

Define the red circle: 

1 . The next shape record does not change any style settings, but moves the drawing position 
to the top of the red circle. 

2. The following eight shape records are curved edges that define the circle. Again, the path 
must finish where it started. 

Define the green rounded-rectangle: 

1 . The next shape record selects the 2-pixel-wide line style, and the green fill. It also moves 
the drawing position to the upper left of the rounded-rectangle. 

2. The following twelve shape records are a mixture of straight shape records (the sides) 
interspersed with curved shape records (the rounded corners). The path finishes where it 
began. 

Shape structures 

Fill styles 

The SWF file format supports three basic types of fills for a shape. 

Solid fill A simple RGB or RGBA color that fills a portion of a shape. An alpha value of 255 

means a completely opaque fill. An alpha value of zero means a completely transparent fill. 

Any alpha between 0 and 255 will be partially transparent. 
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Gradient Fill A gradient fill can be either a linear or a radial gradient. For an in-depth 
description of how gradients are defined, see Gradients. 

Bitmap fill Bitmap fills refer to a bitmap characterld. There are two styles: clipped and tiled. 
A clipped bitmap fill repeats the color on the edge of a bitmap if the fill extends beyond the 
edge of the bitmap. A tiled fill repeats the bitmap if the fill extends beyond the edge of the 
bitmap. 

FILLSTYLEARRAY 

A fill style array enumerates a number of fill styles. The format of a fill style array is described 
in the following table: 

FILLSTYLEARRAY 


Field 

Type 

Comment 

FillStyleCount 

UI8 

Count of fill styles. 

FillStyieCountExtended 

If FillStyleCount = OxFF UI16 

Extended count of fill styles. 



Supported only for Shape2 



and Shapes. 

FillStyies 

FILLSTYLE[FIIIStyleCount] 

Array of fill styles. 
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FILLSTYLE 

The format of a fill style value within the file is described in the following table: 


FILLSTYLE 



Field 

Type 

Comment 

FillStyleType 

UI8 

Type of fill style: 

0x00 = solid fill 

0x10 = linear gradient fill 

0x12 = radial gradient fill 

0x13 = focal radial gradient fill 
(SWF 8 file format and later 
only) 

0x40 = repeating bitmap fill 

0x41 = clipped bitmap fill 

0x42 = non-smoothed 
repeating bitmap 

0x43 = non-smoothed clipped 
bitmap 

Color 

If type = 0x00 RGBA(if 
ShapeO); RGB (if Shapel or 
Shape2) 

Solid fill color with transparency 
information. 

GradientMatrix 

If type = 0x10 or 0x12 

MATRIX 

Matrix for gradient fill. 

Gradient 

If type = 0x10 or 0x12 
GRADIENT 

If type = 0x13 

FOCALGRADIENT (SWF 8 
and later only) 

Gradient fill. 

Bitmapid 

If type = 0x40, 0x41, 0x42 or 
0x43 UI16 

ID of bitmap character for fill. 

BitmapMatrix 

If type = 0x40, 0x41, 0x42 or 
0x43 MATRIX 

Matrix for bitmap fill. 
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Line styles 

A line style array enumerates a number of line styles. 

LINESTYLEARRAY 

The format of a line style array is described in the following table: 


LINESTYLEARRAY 



Field 

Type 

Comment 

LineStyleCount 

UI8 

Count of line styles. 

LineStyleCountExtended 

If LineStyleCount = OxFF UI16 

Extended count of line styles. 

LineStyles 

LINESTYLE[count] (If Shapel, 
Shape2, or Shape3) 
LINESTYLE2[count] (If 
Shape4) 

Array of line styles. 


LINESTYLE 

A line style represents a width and color of a line. The format of a line style value within the 
file is described in the following table: 


LINESTYLE 



Field 

Type 

Comment 

Width 

UI16 

Width of line In twips. 

Color 

RGB (Shapel or Shape2) 
RGBA (Shapes) 

Color value including alpha 
channel Information for 
Shapes. 


z 

0 

H 

m 

Before the introduction of LINESTYLE2 In SWF 8, all lines in the SWF file format have 
rounded joins and round caps. Different join styles and end styles can be simulated with 
a very narrow shape that looks Identical to the desired stroke. 
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The SWF file format has no native support for dashed or dotted line styles. A dashed line 
can be simulated by breaking up the path Into a series of short lines. 
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LINESTYLE2 

LINESTYLE2 builds upon the capabilities of the LINESTYLE record by allowing the use of 
new types of joins and caps as well as scaling options and the ability to fill a stroke. In order to 
use LINESTYLE2, the shape must be defined with DefmeShaped —not DefmeShape, 
DefineShape2, or DefineShaped. 

While the LINESTYLE record permits only rounded joins and round caps, LINESTYLE2 
also supports miter and bevel joins, and square caps and no caps. The following diagram 
illustrates the complete array of joins and caps: 



Miter Join Round Join Bevel Join 



None Cap Round Cap Square Cap 

When using LINESTYLE2 for a miter join, a MiterLimitFactor must be specified and is used 
to calculate the maximum miter length: 

Maximum miter length = LINESTYLE2 MiterLimitFactor * LINESTYLE2 Width 

If the miter join exceeds the maximum miter length. Flash Player will cut off the miter. Note 

that MiterLimitFactor is an 8.8 fixed-point value. 

LINESTYLE2 also includes the option for pixel hinting to correct blurry vertical or 
horizontal lines. 


LINESTYLE2 



Field 

Type 

Comment 

Width 

UI16 

Width of line in twips. 

StartCapStyle 

UB[2] 

Start cap style: 

0 = Round cap 

1 = No cap 

2 = Square cap 
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LINESTYLE2 



Field 

Type 

Comment 

JoinStyle 

UB[2] 

Join style: 

0 = Round join 

1 = Bevel join 

2 = Miter join 

HasFillFlag 

UB[1] 

If 1, fill is defined in FillType. 

If 0, uses Color field. 

NoFIScaleFlag 

UB[1] 

If 1, stroke thickness will not 
scale if the object is scaled 
horizontally. 

NoVScaleFlag 

UB[1] 

If 1, stroke thickness will not 
scale if the object is scaled 
vertically. 

PixelFlintingFlag 

UB[1] 

If 1, all anchors will be aligned 
to full pixels. 

Reserved 

UB[5] 

Must be 0. 

NoClose 

UB[1] 

If 1, stroke will not be closed if 
the stroke’s last point 
matches its first point. Flash 
Player will apply caps instead 
of a join. 

EndCapStyle 

UB[2] 

End cap style: 

0 = Round cap 

1 = No cap 

2 = Square cap 

MiterLimitFactor 

If JoinStyle = 2, UI16 

Miter limit factor is an 8.8 
fixed-point value. 

Color 

If HasFillFlag = 0, RGBA 

Color value including alpha 
channel. 

FillType 

If HasFillFlag = 1, FILLSTYLE 

Fill style for this stroke. 


142 Shapes 



Shape structures 

The SHAPE structure defines a shape without fill style or line style information. 


SHAPE 

SHAPE is used by the DefmeFont tag, to define character glyphs. 

SHAPE 

Field Type Comment 

NumFillBits UB[4] Number of fill index bits. 

NumLineBits UB[4] Number of line index bits. 

ShapeRecords SHAPERECORD[one or Shape records (see following). 

more] 


SHAPEWITHSTYLE 

The SHAPEWITHSTYLE structure extends the SHAPE structure by including fill style and 
line style information. SHAPEWITHSTYLE is used by the DefineShape tag. 

SHAPEWITHSTYLE 


Field 

Type 

Comment 

FillStyles 

FILLSTYLEARRAY 

Array of fill styles. 

LineStyles 

LINESTYLEARRAY 

Array of line styles. 

NumFillBits 

UB[4] 

Number of fill index bits. 

NumLineBits 

UB[4] 

Number of line index bits. 

ShapeRecords 

SHAPERECORD[oneor 

more] 

Shape records (see following). 


The LINESTYLELARRAY and FILLSTYLEARRAY begin at index 1, not index 0. 
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The following diagram illustrates the SHAPEWITHSTYLE structure. 



First, the Fill styles and Line styles are defined. These are defined only once and are referred to 
by array index. 

The blue area represents the array of Shape records. The first shape record selects a fill from 
the fill style array, and moves the drawing position to the start of the shape. This is followed 
by a series of edge records that define the shape. The next record changes the fill style, and the 
subsequent edge records are filled using this new style. 

This tag is a completely autonomous object. The style change records only refer to fill and 
line styles that have been defined in this tag. 

Shape records 

There are four types of shape records: 

■ End shape record 

■ Style change record 

■ Straight edge record 

■ Curved edge record 

All shape records are byte aligned and begin with a TypeFlag. If the TypeFlag is zero, the shape 
record is a non-edge record, and a further five bits of flag information follow. 
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EndShapeRecord 

The end shape record simply indicates the end of the shape record array. It is a non-edge 
record with all five flags equal to zero. 


ENDSHAPERECORD 



Field 

Type 

Comment 

TypeFlag 

UB[1] 

Non-edge record flag. 

Always 0. 

EndOfShape 

UB[5] 

End of shape flag. 

Always 0. 


StyleChangeRecord 

The style change record is also a non-edge record. It can be used to do the following: 

1. Select a fill or line style for drawing. 

2. Move the current drawing position (without drawing). 

3. Replace the current fill and line style arrays with a new set of styles. 

Because fill and line styles often change at the start of a new path, it is useful to perform more 
than one action in a single record. For example, say a DefmeShape tag defines a red circle and 
a blue square. After the circle is closed, it is necessary to move the drawing position, and 
replace the red fill with the blue fill. The style change record can achieve this with a single 
shape record. 


STYLECHANGERECORD 

Field Type Comment 


TypeFlag 

UB[1] 

Non-edge record flag. 
Always 0. 

SfateNewStyles 

UB[1] 

New styles flag. Used by 
DefineShape2 and 
DefineShapeS only. 

StateLineStyle 

UB[1] 

Line style change flag. 

StateFillStylel 

UB[1] 

Fill style 1 change flag. 

StateFillStyleO 

UB[1] 

Fill style 0 change flag. 

StateMoveTo 

UB[1] 

Move to flag. 

Move Bits 

If StateMoveTo 

UB[5] 

Move bit count. 
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STYLECHANGERECORD 

Field Type Comment 


MoveDeltaX 

If StateMoveTo 
SB[MoveBits] 

Delta X value. 

MoveDeltaY 

If StateMoveTo 
SB[MoveBits] 

Delta Y value. 

FillStyleO 

If StateFillStyleO 
UB[FillBits] 

Fill 0 Style. 

FillStylel 

If StateFillStylel 
UB[FillBits] 

Fill 1 Style. 

LineStyle 

If StateLineStyle 
UB[LineBits] 

Line Style. 

FillStyles 

If StateNewStyles 
FILLSTYLEARRAY 

Array of new fill styles. 

LineStyles 

If StateNewStyles 
LINESTYLEARRAY 

Array of new line styles. 

NumFillBits 

If StateNewStyles 

UB[4] 

Number of fill index bits for new 
styles. 

NumLineBits 

If StateNewStyles 

UB[4] 

Number of line index bits for 
new styles. 


In the first shape record MoveDel taX and MoveDel taY are relative to the shape origin. 

In subsequent shape records, MoveDel taX and MoveDel taY are relative to the current 
drawing position. 

The style arrays begin at index 1, not index 0. FillStyle = 1 refers to the first style in the fill 
style array, FillStyle = 2 refers to the second style in the fill style array, and so on. A fdl style 
index of zero means the path is not filled, and a line style index of zero means the path has no 
stroke. Initially the fill and line style indices are set to zero—no fill or stroke. 

FillStyleO and FillStylel 

Flash supports two fill styles per edge, one for each side of the edge; FillStyleO and FillStylel. 
For shapes that don’t self-intersect or overlap, FillStyleO should be used. For overlapping 
shapes the situation is more complex. 
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For example, if a shape consists of two overlapping squares, and only FillStyleO is defined. 
Flash Player renders a ‘hole’ where the paths overlap. This area can be filled using FillStylel. 
In this situation, the rule is that for any directed vector, FillStyleO is the color to the left of the 
vector, and FillStylel is the color to the right of the vector (as shown in the following 
diagram). 


fillStyle 0 vs 

fillStyle 1 


f0=3 

f1=0 



f1=1 
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FillStyleO and FillStylel should not be confused with FILLSTYLEARRAY indices. 
FillStyleO and FillStylel are variables that contain indices into the FILLSTYLEARRAY. 
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Edge records 

Edge records have a TypeFlag of 1. There are two types of edge records: straight and curved. 
The StraightFlag determines the type. 

StraightEdgeRecord 

The StraightEdgeRecord stores the edge as an X- Y delta. The delta is added to the current 
drawing position, and this becomes the new drawing position. The edge is rendered between 
the old and new drawing positions. 

Straight edge records support three types of lines: 

1. General lines. 

2. Horizontal lines. 

3. Vertical lines. 

General lines store both X and Y deltas, the horizontal and vertical lines store only the X delta 
and Y delta respectively. 


STRAIGHTEDGERECORD 

Field 

Type 

Comment 

TypeFlag 

UB[1] 

This is an edge record. 

Always 1. 

StraightFlag 

UB[1] 

Straight edge. 

Always 1. 

NumBits 

UB[4] 

Number of bits per value 
(2 less than the actual number). 

GeneralLineFlag 

UB[1] 

General Line equals 1. 

Vert/Horz Line equals 0. 

VertLineFlag 

If GeneralLineFlag = 0 
SB[1] 

Vertical Line equals 1. 

Horizontal Line equals 0. 

DeltaX 

If GeneralLineFlag = 1 or 
if VertLineFlag = 0 
SB[NumBits+2] 

X delta. 

DeltaY 

If GeneralLineFlag = 1 or 
if VertLineFlag = 1 
SB[NumBits+2] 

V delta. 
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CurvedEdgeRecord 

The SWF file format differs from most vector file formats by using Quadratic Bezier curves 
rather than Cubic Bezier curves. PostScript uses Cubic Bezier curves, as do most drawing 
applications.The SWF file format uses Quadratic Bezier curves because they can be stored 
more compactly, and can be rendered more efficiently. 

The following diagram shows a Quadratic Bezier curve and a Cubic Bezier curve. 



A Quadratic Bezier curve has 3 points: 2 on-curve anchor points, and 1 off-curve control 
point. A Cubic Bezier curve has 4 points: 2 on-curve anchor points, and 2 off-curve control 
points. 

The curved-edge record stores the edge as two X-V deltas. The three points that define the 
Quadratic Bezier are calculated like this: 

1 . The first anchor point is the current drawing position. 

2. The control point is the current drawing position + ControlDelta. 

3. The last anchor point is the current drawing position + ControlDelta + AnchorDelta. 
The last anchor point becomes the current drawing position. 

CURVEDEDGERECORD 


Field 

Type 

Comment 

TypeFlag 

UB[1] 

This is an edge record. 

Always 1. 

StraightFlag 

UB[1] 

Curved edge. 

Always 0. 

NumBits 

UB[4] 

Number of bits per value 
(2 less than the actual number). 

ControlDeltaX 

SB[NumBits+2] 

X control point change. 

ControlDeltaY 

SB[NumBits+2] 

V control point change. 

AnchorDeltaX 

SB[NumBits+2] 

X anchor point change. 

AnchorDeltaY 

SB[NumBits+2] 

V anchor point change. 
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Converting between quadratic and cubic Bezier curves 

Replace the single off-curve control point of the quadratic Bezier curve with two new 
off-curve control points for the cubic Bezier curve. Place each new off-curve control point 
along the line between one of the on-curve anchor points and the original off-curve control 
point. The new off-curve control points should be 2/3 of the way from the on-curve anchor 
point to the original off-curve control point. The diagram of quadratic and cubic Bezier 
curves above illustrates this substitution. 

A cubic Bezier curve can be approximated only with a quadratic Bezier curve, because you 
are going from a third-order curve to a second-order curve. This involves recursive subdivision 
of the curve, until the cubic curve and the quadratic equivalent are matched within some 
arbitrary tolerance. 

For a discussion of how to approximate cubic Bezier curves with quadratic Bezier curves see 
the following: 

■ Converting Bezier Curves to Quadratic Splines at http://stevehollasch.com/cgindex/curves/ 
cbez-quadspline.html 

■ TrueType Reference Manual, Converting Outlines to the TrueType Format at http:// 
developer.apple.com/fonts/TTRefMan/RM08/appendixE.html 

Shape tags 

DefineShape 

The DefineShape tag defines a shape for later use by control tags such as PlaceObject. The 
Shapeld uniquely identifies this shape as ‘character’ in the Dictionary. The ShapeBounds field 
is the rectangle that completely encloses the shape. The SHAPEWITHSTYLE structure 
includes all the paths, fill styles and line styles that make up the shape. 

The minimum file format version is SWF 1. 

DefineShape 


Field 

Type 

Comment 


Header 

RECORDHEADER 

Tag type = 2. 


Shapeld 

UI16 

ID for this character. 


ShapeBounds 

RECT 

Bounds of the shape. 


Shapes 

SHAPEWITHSTYLE 

Shape information. 
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DefineShape2 

DefineShape2 extends the capabilities of DefmeShape with the ability to support more than 
255 styles in the style list and multiple style lists in a single shape. 

The minimum file format version is SWF 2. 


DefineShape2 

Field 

Type 

Comment 

Header 

RECORDHEADER 

Tag type = 22. 

Shapeld 

UI16 

ID for this character. 

ShapeBounds 

RECT 

Bounds of the shape. 

Shapes 

SHAPEWITHSTYLE 

Shape information. 

DefineShapeS 

DefineShaped extends the capabilities of DefineShape2 by extending all of the RGB color 
fields to support RGBA with alpha transparency. 

The minimum file format version is SWF 3. 

DefineShapeS 

Field 

Type 

Comment 

Header 

RECORDHEADER 

Tag type = 32. 

Shapeld 

UI16 

ID for this character. 

ShapeBounds 

RECT 

Bounds of the shape. 

Shapes 

SHAPEWITHSTYLE 

Shape information. 

DefineShape4 

DefineShaped extends the 

capabilities of DefineShapeS by using a new line style record in the 

shape. LINESTYLE2 allows new types of joins and caps 
ability to fill a stroke. 

as well as scaling options and the 
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DefineShape4 specifies not only the shape bounds but also the edge bounds of the shape. 
While the shape bounds are calculated along the outside of the strokes, the edge bounds are 
taken from the outside of the edges, as shown in the following diagram. The EdgeBounds 
field assists Flash Player in accurately determining certain layouts. 


Strokes 

Edges 

Shape bounds 
Edge bounds 


In addition, DefmeShape4 includes new hinting flags UsesNonScalingStrokes and 
UsesScalingStrokes. These flags assist Flash Player in creating the best possible area for 
invalidation. 

The minimum file format version is SWF 8. 

DefineShape4 


Field 

Type 

Comment 

Header 

RECORDHEADER 

Tag type = 83. 

Shapeld 

UI16 

ID for this character. 

ShapeBounds 

RECT 

Bounds of the shape. 

EdgeBounds 

RECT 

Bounds of the shape, excluding 
strokes. 

Reserved 

UB[6] 

Must be 0. 

UsesNonScalingStrokes 

UB[1] 

If 1, the shape contains at least 
one non-scaling stroke. 

UsesScalingStrokes 

UB[1] 

If 1, the shape contains at least 
one scaling stroke. 

Shapes 

SHAPEWITHSTYLE 

Shape information. 
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CHAPTER 9 

Gradients 


Gradients are a special type of shape fill for Macromedia Flash (SWF) shapes. They create 

ramps of colors that interpolate between two or more fixed colors. 

Flere is an overview of the Macromedia Flash (SWF) gradient model: 

■ There are two styles of gradient; Linear and Radial. In addition, with the SWF 8 file 
format, a new radial gradient type is added to allow the focal point to be set. 

■ Each gradient has its own transformation matrix, and can be transformed independently 
of its parent shape. 

■ A gradient can have up to eight control points in SWF 7 file format and previous versions, 
or up to fifteen control points in SWF 8 and later. Colors are interpolated between the 
control points to create the color ramp. 

■ Each control point is defined by a ratio and an RGBA color. The ratio determines the 
position of the control point in the gradient; the RGBA value determines its color. 

Following are some examples of Flash gradients (from left to right): 

■ A simple white-to-black linear gradient. 

■ A simple white-to-black radial gradient. 

■ A “rainbow” gradient consisting of seven control points; red, yellow, green, cyan, blue, 
purple, and red. 

■ A three-point gradient, where the end points are opaque and the center point is 
transparent. The result is a gradient in the alpha-channel that allows the diamond shape in 
the background to show through. 


ana 
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Gradient transformations 

All gradients are defined in a standard space called the gradient square. The gradient square is 
centered at (0,0), and extends from (-16384,-16384) to (16384,16384). 

Each gradient is mapped from the gradient square to the display surface using a standard 
transformation matrix. This matrix is stored in the FILLSTYLE structure. 

Example: In the following diagram a linear gradient is mapped onto a circle 4096 units in 
diameter, and centered at (2048,2048). 

(-16384,-16364) (16384,-16384) 



(-16384,16384) (16384,16384) 

The 2x3 MATRIX required for this mapping is: 

I 0.125 0.000 1 

I 0.000 0.125 I 

I 2048.0002048.000 | 

The gradient is scaled to one-eighth of its original size (32768 / 4096 = 8), and translated to 
(2048, 2048). 

Gradient control points 

The position of a control point in the gradient is determined by a ratio value between 0 and 
255. For a linear gradient, a ratio of zero maps to the left side of the gradient square, and a 
ratio of 255 maps to the right side. For a radial gradient, a ratio of zero maps to the center 
point of the gradient square, and a ratio of 255 maps to the largest circle that fits inside the 
gradient square. 

The color of a control point is determined by an RGBA value. An alpha value of zero means 
the gradient is completely transparent at this point. An alpha value of 255 means the gradient 
is completely opaque at this point. 

Control points are sorted by ratio, with the smallest ratio first. 
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Gradient structures 

The gradient structures are part of the FILLSTYLE structure. 


GRADIENT 

SWF 8 and later supports up to 15 gradient control points, spread modes and a new 
interpolation type. 

Note that for the DefmeShape, DefmeShape2 or DefmeShaped tags, the SpreadMode and 
InterpolationMode fields must be 0, and the NumGradients field can not exceed 8. 


GRADIENT 

Field 

SpreadMode 


InterpolationMode 


NumGradients 

GradientRecords 


Type Comment 

UB[2] 0 = Pad mode 

1 = Reflect mode 

2 = Repeat mode 

3 = Reserved 

UB[2] 0 = Normal RGB mode 

interpolation 

1 = Linear RGB mode 
interpolation 

2 and 3 = Reserved 

UB[4] 1to15 

GRADRECORD[nGrads] Gradient records (see 

following) 
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FOCALGRADIENT 


A FOCALGRADIENT must be declared in DefineShaped —not DefineShape, DefineShape2 
or DefmeShaped. 

The value range is from -1.0 to 1.0, where -1.0 means the focal point is close to the left border 
of the radial gradient circle, 0.0 means that the focal point is in the center of the radial 
gradient circle, and 1.0 means that the focal point is close to the right border of the radial 
gradient circle. 

FOCALGRADIENT 


Field 

Type 

Comment 

SpreadMode 

UB[2] 

0 = Pad mode 

1 = Reflect mode 

2 = Repeat mode 

3 = Reserved 

InterpolationMode 

UB[2] 

0 = Normal RGB mode 
interpolation 

1 = Linear RGB mode 
interpolation 

2 and 3 = Reserved 

NumGradients 

UB[4] 

1to15 

GradientRecords 

GRADRECORD[nGrads] 

Gradient records (see 
following) 

FocalPoint 

FIXED8 

Focal point location 


GRADRECORD 


The GRADRECORD defines 

a gradient control point: 


GRADRECORD 



Field 

Type 

Comment 

Ratio 

UI8 

Ratio value 

Color 

RGB (Shapel or Shape2) 
RGBA (Shape3) 

Color of gradient 
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CHAPTER 10 


Bitmaps 


10 


The Macromedia Flash SWF 8 file format specification supports a variety of bitmap formats. 
All bitmaps are compressed to reduce file size. Lossy compression, best for imprecise images 
such as photographs, is provided by JPEG bitmaps; lossless compression, best for precise 
images such as diagrams, icons, or screen captures, is provided by ZLIB bitmaps. Both types 
of bitmaps can optionally contain alpha channel (transparency) information. 

The JPEG format, officially defined as ITU T.81 or ISO/IEC 10918-1, is an open standard 
developed by the Independent Joint Photographic Experts Group. The JPEG format is not 
described in this document. For general information on the JPEG format, see JPEG at 
www.jpeg.org/. For a specification of the JPEG format, see the International 
Telecommunication Union at www.itu.int/ and search for recommendation T.81. The JPEG 
data in SWF files is encoded using the JPEG Interchange Format specified in Annex B. Flash 
Player also understands the popular JFIF format, an extension of the JPEG Interchange 
Format. 

In all cases where arrays of non-JPEG pixel data are stored in bitmap tags, the pixels appear 
in row-major order, reading like English text, proceeding left to right within rows and top to 
bottom overall. 


DefineBits 


This tag defines a bitmap character with JPEG compression. It contains only the JPEG 
compressed image data (from the Frame Header onward). A separate JPEGTables tag contains 
the JPEG encoding data used to encode this image (the Tables/Misc segment). 
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Only one JPEGTables tag is allowed In a SWF file, and thus all bitmaps defined with 
DefineBits must share common encoding tables. 


The data in this tag begins with the JPEG SOI marker OxFF, 0xD8 and ends with the EOI 
marker OxFF, 0xD9. Before the SWF 8 file format, SWF files could contain an erroneous 
header of OxFF, 0xD9, OxFF, 0xD8 before the JPEG SOI marker. 
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The minimum file format version is SWF 1. 


DefineBits 



Field 

Type 

Comment 

Header 

RECORDHEADER (long) 

Tag type = 6 

CharacterlD 

UI16 

ID for this character 

JPEGData 

UI8[image data size] 

JPEG compressed image 


JPEGTables 

This tag defines the JPEG encoding table (the Tables/Misc segment) for all JPEG images 
defined using the DefineBits tag. There may only be one JPEGTables tag in a SWF file. 

The data in this tag begins with the JPEG SOI marker OxFF, 0xD8 and ends with the EOI 
marker OxFF, 0xD9. Before SWF 8, SWF files could contain an erroneous header of OxFF, 
0xD9, OxFF, 0xD8 before the JPEG SOI marker. 

The minimum file format version is SWF 1. 


JPEGTables 




Field 

Type 

Comment 


Header 

RECORDHEADER 

Tag type = 8 


JPEGData 

UI8[encoding data size] 

JPEG encoding table 



DefineBitsJPEG2 

This tag defines a bitmap character with JPEG compression. It differs from DefineBits in that 
it contains both the JPEG encoding table and the JPEG image data. This tag allows multiple 
JPEG images with differing encoding tables to be defined within a single SWF file. 

The data in this tag begins with the JPEG SOI marker OxFF, 0xD8 and ends with the EOI 
marker OxFF, 0xD9. Before SWF 8, SWF files could contain an erroneous header of OxFF, 
0xD9, OxFF, 0xD8 before the JPEG SOI marker. 
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The minimum file format version is SWF 2. 


DefineBitsJPEG2 



Field 

Type 

Comment 

Header 

RECORDHEADER (long) 

Tag type = 21 

CharacterlD 

UI16 

ID for this character 

JPEGData 

UI8[data size] 

JPEG encoding table and 
compressed image 


DefineBitsJPEGS 

Defines a bitmap character with JPEG compression. This tag extends DefineBitsJPEG2, 
adding alpha channel (transparency) data. Transparency is not a standard feature in JPEG 
images, so the alpha channel information is encoded separately from the JPEG data, and 
compressed using the ZLIB standard for compression. The data format used by the ZLIB 
library is described by Request for Gomments (RFCs) documents 1950 to 1952. 

The data in this tag begins with the JPEG SOI marker OxFF, 0xD8 and ends with the EOI 
marker OxFF, 0xD9. Before SWF 8, SWF files could contain an erroneous header of OxFF, 
0xD9, OxFF, 0xD8 before the JPEG SOI marker. 

The minimum file format version is SWF 3. 


DefineBitsJPEGS 



Field 

Type 

Comment 

Header 

RECORDHEADER (long) 

Tag type = 35. 

CharacterlD 

UI16 

ID for this character. 

AlphaDataOffset 

UI32 

Count of bytes in JPEGData. 

JPEGData 

UI8[data size] 

JPEG encoding table and 
compressed image. 

BitmapAlphaData 

UI8[alpha data size] 

ZLIB compressed array of 
alpha data. One byte per pixel. 
Total size after decompression 
must equal (width * height) of 
JPEG image. 



DefineBitsJPEGS 159 











DefineBitsLossless 

Defines a lossless bitmap character that contains RGB bitmap data compressed with ZLIB. 
The data format used by the ZLIB library is described by Request for Comments (RFCs) 
documents 1950 to 1952. 

Two kinds of bitmaps are supported. Colormapped images define a colormap of up to 256 
colors, each represented by a 24-bit RGB value, and then use 8-bit pixel values to index into 
the colormap. Direct images store actual pixel color values using 15 bits (32,768 colors) or 24 
bits (about 17 million colors). 

The minimum file format version is SWF 2. 


DefineBitsLossless 



Field 

Type 

Comment 

Header 

RECORDHEADER(long) 

Tag type = 20 

CharacterlD 

UI16 

ID for this character 

BitmapFormat 

UI8 

Format of compressed data 

3 = 8-bit colormapped image 

4 = 15-bit RGB image 

5 = 24-bit RGB image 

BitmapWidth 

UI16 

Width of bitmap image 

BitmapHeight 

UI16 

Height of bitmap image 

BitmapColorT ableSize 

If BitmapFormat = 3 UI8 
Otherwise absent 

This value is one less than the 
actual number of colors in the 
color table, allowing for up to 
256 colors. 

ZlibBitmapData 

If BitmapFormat = 3 
COLORMAPDATA 

If BitmapFormat = 4 or 5 
BITMAPDATA 

ZLIB compressed bitmap data 
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The COLORMAPDATA and BITMAPDATA structures contain image data. These 
structures are each compressed as a single block of data. Their layouts before compression 
follow. 
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Row widths in the pixel data fields of these structures must be rounded up to the next 
32-bit word boundary. For example, an 8-bit image that is 253 pixels wide must be 
padded out to 256 bytes per line. To determine the appropriate padding, make sure to 
take into account the actual size of the individual pixel structures; 15-bit pixels occupy 2 
bytes and 24-bit pixels occupy 4 bytes (see PIX15 and PIX24 1. 


COLORMAPDATA 



Field 

Type 

Comment 

ColorTableRGB 

RGB[color table size] 

Defines the mapping from color 
indices to RGB values. Number 

of RGB values is 
BitmapColorTableSize +1. 

ColormapPixelData 

UI8[image data size] 

Array of color indices. Number 
of entries is BitmapWidth * 
BitmapHeight, subject to 
padding (see Note preceding 
this table). 


BITMAPDATA 

Field 

Type 

Comment 

BitmapPixelData 

If BitmapFormat = 4 

Array of pixel colors. Number of 


PIX15[image data size] 

entries is BitmapWidth * 


If BitmapFormat = 5 

BitmapHeight, subject to 


PIX24[image data size] 

padding (see Note above). 


PIX15 

Field 

Type 

Comment 


Pix15Reserved 

UB[1] 

Always 0 


Pix15Red 

UB[5] 

Red value 


Pix15Green 

UB[5] 

Green value 


Pix15Blue 

UB[5] 

Blue value 
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PIX24 

Field 

Type 

Comment 

Pix24Reserved 

UI8 

Always 0 

Pix24Red 

UI8 

Red value 

Pix24Green 

UI8 

Green value 

Pix24Blue 

UI8 

Blue value 


DefineBitsLossless2 

DefineBitsLossless2 extends DefineBitsLossless with support for transparency (alpha values). 
The colormap colors in colormapped images are defined using RGBA values, and direct 
images store 32-bit ARGB colors for each pixel. The intermediate 15-bit color depth is not 
available in DefineBitsLossless2. 

The minimum file format version is SWF 3. 

DefineBitsLossless2 


Field 

Type 

Comment 

Header 

RECORDHEADER (long) 

Tag type = 36 

CharacterlD 

UI16 

ID for this character 

BItmapFormat 

UI8 

Format of compressed data 

3 = 8-bit colormapped Image 

5 = 32-blt ARGB Image 

BItmapWidth 

UI16 

Width of bitmap Image 

BItmapHelght 

UI16 

Height of bitmap image 

BItmapColorT ableSize 

If BItmapFormat = 3 UI8 
Otherwise absent 

This value is one less than the 

actual number of colors In the 
color table, allowing for up to 
256 colors. 

ZlIbBitmapData 

If BItmapFormat = 3 
ALPHACOLORMAPDATA 

If BItmapFormat = 4 or 5 
ALPHABITMAPDATA 

ZLIB compressed bitmap data 
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The COLORMAPDATA and BITMAPDATA structures contain image data. These 
structures are each compressed as a single block of data. Their layouts before compression 
follow. 
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Row widths in the pixel data field of ALPHACOLORMAPDATA must be rounded up to 
the next 32-bit word boundary. For example, an 8-bit image that is 253 pixels wide must 
be padded out to 256 bytes per line. Row widths in ALPHABITMAPDATA are always 
32-bit aligned because the ARGB structure is 4 bytes. 


ALPHACOLORMAPDATA 


Field 

Type 

Comment 

ColorTableRGB 

RGBA[color table size] 

Defines the mapping from color 
indices to RGBA values. 

Number of RGBA values is 
BitmapColorTableSize +1. 

ColormapPixelData 

UI8[image data size] 

Array of color indices. Number 
of entries is BitmapWidth * 
BitmapHeight, subject to 
padding (see Note preceding 
this table). 


ALPHABITMAPDATA 
Field Type 

BitmapPixelData ARGB[image data size] 


Comment 

Array of pixel colors. Number of 
entries is BitmapWidth * 
BitmapHeight. The RGB data 
must already be multiplied by 
the alpha channel value. 
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CHAPTER 11 
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Shape Morphing 


Shape morphing is the metamorphosis of one shape into another over time. The Macromedia 
Flash SWF 8 file format specification supports a flexible morphing model, which allows a 
number of shape attributes to vary during the morph. The SWF file format defines only the 
start and end states of the morph. Macromedia Flash Player is responsible for interpolating 
between the endpoints and generating the ‘in-between’ states. 

The following shape attributes can be varied during the morph: 

■ The position of each edge in the shape. 

■ The color and thickness of the outline. 

■ The fill color of the shape (if filled with a color). 

■ The bitmap transform (if filled with a bitmap). 

■ The gradient transform (if filled with a gradient). 

■ The color and position of each point in the gradient (if filled with a gradient). 

The following restrictions apply to morphing: 

■ The start and end shapes must have the same number of edges. 

■ The start and end shapes must have the same type of fill (that is, solid, gradient or bitmap). 

■ The style change records must be the same for the start and end shapes. 

■ If filled with a bitmap, both shapes must be filled with the same bitmap. 

■ If filled with a gradient, both gradients must have the same number of color points. 
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The following illustration shows a morph from a blue rectangle to a red quadrilateral 
frames. The green outlines represent the ‘in-between’ shapes of the morph sequence, 
shapes have the same number of points, and the same type of fill, namely a solid fill, 
changing shape, the shape also gradually changes color from blue to red. 



There are two tags involved in defining and playing a morph sequence: 

■ DefmeMorphShape 

■ PlaceObject2 

DefmeMorphShape defines the start and end states of the morph. A morph object does not 
use previously defined shapes; it is considered a special type of shape with only one character 
ID. DefineMorphShape contains a list of edges for both the start and end shapes. It also 
defines the fill and line styles, as they are at the start and end of the morph sequence. 

The PlaceObject 2 tag displays the morph object at some point in time during the morph 
sequence. The ratio field controls how far the morph has progressed. A ratio of zero produces 
a shape identical to the start condition. A ratio of 65535 produces a shape identical to the 
end condition. 


over five 

Both 

Besides 
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DefineMorphShape 

The DefineMorphShape tag defines the start and end states of a morph sequence. A morph 
object should be displayed with the PlaceObject2 tag, where the ratio field specifies how far 
the morph has progressed. 

The minimum file format version is SWF 3. 


DefineMorphShape 

Field Type Comment 


Header 

Characterld 

StartBounds 

EndBounds 

Offset 

MorphFillStyles 


MorphLineStyles 


RECORDHEADER 

UI16 

RECT 

RECT 

UI32 

Morph fill styles 


MORPHLINESTYLES 


Tag type = 46 

ID for this character 

Bounds of the start shape 

Bounds of the end shape 

Indicates offset to EndEdges 

Fill style information is stored in 
the same manner as for a 
standard shape; however, each 
fill consists of interleaved 
information based on a single 
style type to accommodate 
morphing. 

Line style information is stored 
in the same manner as for a 
standard shape; however, each 
line consists of interleaved 
information based on a single 
style type to accommodate 
morphing. 


DefineMorphShape 167 





DefineMorphShape 



Field 

Type 

Comment 

StartEdges 

SHAPE 

Contains the set of edges and 
the style bits that indicate style 
changes (for example, MoveTo, 
FillStyle, and LineStyle). 

Number of edges must equal 
the number of edges in 
EndEdges. 

EndEdges 

SHAPE 

Contains only the set of edges, 
with no style information. 
Number of edges must equal 
the number of edges in 
StartEdges. 


StartBounds This defines the bounding-box of the shape at the start of the morph. 
EndBounds This defines the bounding-box at the end of the morph. 

MorphFillStyles This contains an array of interleaved fill styles for the start and end shapes. 
The fill style for the start shape is followed by the corresponding fill style for the end shape. 
MorphLineStyles This contains an array of interleaved line styles. 

StartEdges This array specifies the edges for the start shape, and the style change records 
for both shapes. Because the StyleChangeRecords must be the same for the start and end 
shapes, they are defined only in the StartEdges array. 

EndEdges This array specifies the edges for the end shape, and contains no style change 
records. The number of edges specified in StartEdges must equal the number of edges in 
EndEdges. 
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Strictly speaking, MoveTo records fall into the category of StyleChangeRecords; 
however, they should be included in both the StartEdges and EndEdges arrays. 


It is possible for an edge to change type over the course of a morph sequence. A straight edge 
can become a curved edge and vice versa. In this case, think of both edges as curved. A straight 
edge can be easily represented as a curve, by placing the off-curve (control) point at the 
midpoint of the straight edge, and the on-curve (anchor) point at the end of the straight edge. 
The calculation is as follows: 


CurveControlDelta.x 
CurveControlDelta.y 
CurveAnchorDelta. x 
CurveAnchorDelta .y 


StraightDelta.X / 2 
StraightDelta.y / 2 
StraightDelta .X / 2 
StraightDelta.y / 2 
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DefineMorphShape2 

The DefineMorphShape2 tag extends the capabilities of DefineMorphShape by using a new 
morph line style record in the morph shape. MORPHLINESTYLE2 allows the use of new 
types of joins and caps as well as scaling options and the ability to fdl the strokes of the morph 
shape. 

DefmeMorphShape2 specifies not only the shape bounds but also the edge bounds of the 
shape. While the shape bounds are calculated along the outside of the strokes, the edge 
bounds are taken from the outside of the edges. For an example of shape bounds versus edge 
bounds, see the diagram in DefineShaped. The new StartEdgeBounds and EndEdgeBounds 
fields assist Flash Player in accurately determining certain layouts. 

In addition, DeflneMorphShape2 includes new hinting information, UsesNonScalingStrokes 
and UsesScalingStrokes. These flags assist Flash Player in creating the best possible area for 
invalidation. 

The minimum file format version is SWF 8. 


DefineMorphShape2 



Field 

Type 

Comment 

Header 

RECORDHEADER 

Tag type = 84 

Characterld 

UI16 

ID for this character 

StartBounds 

RECT 

Bounds of the start shape 

EndBounds 

RECT 

Bounds of the end shape 

StartEdgeBounds 

RECT 

Bounds of the start shape, 
excluding strokes 

EndEdgeBounds 

RECT 

Bounds of the end shape, 
excluding strokes 

Reserved 

UB[6] 

Must be 0 

UsesNonScalingStrokes 

UB[1] 

If 1, the shape contains at least 
one non-scaling stroke. 

UsesScalingStrokes 

UB[1] 

If 1, the shape contains at least 
one scaling stroke. 

Offset 

UI32 

Indicates offset to EndEdges 


DefineMorphShape2 169 





DefineMorphShape2 

Field Type Comment 

MorphFillStyles Morph fill styles Fill style information is stored in 

the same manner as for a 
standard shape; however, each 
fill consists of interleaved 
information based on a single 
style type to accommodate 
morphing. 

MorphLineStyles MORPHLINESTYLES Line style information is stored 

in the same manner as for a 
standard shape; however, each 
line consists of interleaved 
information based on a single 
style type to accommodate 
morphing. 

StartEdges SHAPE Contains the set of edges and 

the style bits that indicate style 
changes (for example, MoveTo, 
FillStyle, and LineStyle). 
Number of edges must equal 
the number of edges in 
EndEdges. 

EndEdges SHAPE Contains only the set of edges, 

with no style information. 
Number of edges must equal 
the number of edges in 
StartEdges. 
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Morph fill styles 


MORPHFILLSTYLEARRAY 

A morph fill style array enumerates a number of fill styles. 


MORPHFILLSTYLEARRAY 


Field 

Type 

Comment 

FillStyleCount 

Count = UI8 

Count of fill styles. 

FillStyleCountExtended 

If Count = OxFF 

UI16 

Extended count of fill styles. 

FillStyles 

MORPHFILLSTYLE[count] Array of fill styles. 

MORPHFILLSTYLE 


A fill style represents how 

a closed shape is filled in. 


MORPHFILLSTYLE 



Field 

Type 

Comment 

FillStyleType 

UI8 

Type of fill style 

0x00 = solid fill 

0x10 = linear gradient fill 

0x12 = radial gradient fill 

0x40 = repeating bitmap 

0x41 = clipped bitmap fill 

0x42 = non-smoothed 
repeating bitmap 

0x43 = non-smoothed clipped 
bitmap 

StartColor 

If type = 0x00 RGBA 

Solid fill color with transparency 
information for start shape. 

EndColor 

If type = 0x00 RGBA 

Solid fill color with transparency 
information for end shape. 

StartGradientMatrix 

If type = 0x10 or 0x12 
MATRIX 

Matrix for gradient fill for start 
shape. 

EndGradientMatrix 

If type = 0x10 or 0x12 
MATRIX 

Matrix for gradient fill for end 
shape. 
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MORPHFILLSTYLE 



Field 

Type 

Comment 

Gradient 

If type = 0x10 or 0x12 
MORPHGRADIENT 

Gradient fill. 

Bitmapid 

If type = 0x40, 0x41, 0x42 or 
0x43 UI16 

ID of bitmap character for fill. 

StartBitmapMatrix 

If type = 0x40, 0x41, 0x42 or 

Matrix for bitmap fill for start 


0x43 MATRIX 

shape. 

EndBitmapMatrix 

If type = 0x40, 0x41, 0x42 or 

Matrix for bitmap fill for end 


0x43 MATRIX 

shape. 

Morph gradient values 


Morph gradient values control gradient information for a fdl style. 

MORPHGRADIENT 


The format of gradient information is described in the following table: 

MORPHGRADIENT 



Field 

Type 

Comment 

NumGradients 

UI8 

Ito 8. 

GradientRecords 

MORPHGRADRECORD 

Gradient records (see 


[NumGradients] 

following). 


MORPHGRADRECORD 

The gradient record format is described in the following table: 


MORPHGRADRECORD 

Field Type Comment 


StartRatio 

UI8 

Ratio value for start shape. 

StartColor 

RGBA 

Color of gradient for start 



shape. 

EndRatio 

UI8 

Ratio value for end shape. 

EndColor 

RGBA 

Color of gradient for end shape. 
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Morph line styles 


A morph line style array enumerates a number of fill styles. 

MORPHLINESTYLES 

The format of a line style array is described in the following table. 


MORPHLINESTYLES 



Field 

Type 

Comment 

LineStyleCount 

UI8 

Count of line styles. 

LineStyleCountExtended 

If count = OxFF 

UI16 

Extended count of line styles. 

LineStyles 

MORPHLINESTYLE[count] 
(if MorphShapel) 
MORPHLINESTYLE2[coun 
t] (if MorphShape2) 

Array of line styles. 

A line style represents a width and color of a line. 


MORPHLINESTYLE 


The format of a line style value within the file is described in 

the following table. 

MORPHLINESTYLE 



Field 

Type 

Comment 

StartWidth 

UI16 

Width of line in start shape in 
twips. 

EndWidth 

UI16 

Width of line in end shape in 
twips. 

StartColor 

RGBA 

Color value including alpha 
channel information for start 
shape. 

EndColor 

RGBA 

Color value including alpha 
channel information for end 
shape. 


Morph line styles 173 



MORPHLINESTYLE2 


MORPHLINESTYLE2 builds upon the capabilities of the MORPHLINESTYLE record by 
allowing the use of new types of joins and caps as well as scaling options and the ability to fill 
morph strokes. In order to use MORPHLINESTYLE2, the shape must be defined with 
DefineMorphShape2 —not DefineMorphShape. 

While the MORPHLINESTYLE record permits only rounded joins and round caps, 
MORPHLINESTYLE2 also supports miter and bevel joins, and square caps and no caps. For 
an illustration of the available joins and caps, see the diagram in the LINESTYLE2 
description. 

When using MORPHLINESTYLE for a miter join, a MiterLimitFactor must be specified 
and is used along with StartWidth or EndWidth to calculate the maximum miter length; 
Max miter length = MORPHLINESTYLE2 MiterLimitFactor * MORPHLINESTYLE2 
Width 

If the miter join exceeds the maximum miter length. Flash Player will cut off the miter. Note 
that MiterLimitFactor is an 8.8 fixed-point value. 

MORPHLINESTYLE2 also includes the option for pixel hinting in order to correct blurry 
vertical or horizontal lines. 


MORPHLINESTYLE2 



Field 

Type 

Comment 

StartWidth 

UI16 

Width of line in start shape in 
twips. 

EndWidth 

UI16 

Width of line in end shape in 
twips. 

StartCapStyle 

UB[2] 

Start-cap style: 

0 = Round cap 

1 = No cap 

2 = Square cap 

JoinStyle 

UB[2] 

Join style: 

0 = Round join 

1 = Bevel join 

2 = Miter join 

HasFillFlag 

UB[1] 

If 1, fill is defined in FillType. 

If 0, uses StartColor and 
EndColor fields. 
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MORPHLINESTYLE2 



Field 

Type 

Comment 

NoHScaleFlag 

UB[1] 

If 1, stroke thickness will not 
scale if the object is scaled 
horizontally. 

NoVScaleFlag 

UB[1] 

If 1, stroke thickness will not 
scale if the object is scaled 
vertically. 

PixelHintingFlag 

UB[1] 

If 1, all anchors will be aligned to 
full pixels. 

Reserved 

UB[5] 

Must be 0. 

NoClose 

UB[1] 

If 1, stroke will not be closed if 
the stroke’s last point matches 
its first point. Flash Player will 
apply caps instead of a join. 

EndCapStyle 

UB[2] 

End-cap style: 

0 = Round cap 

1 = No cap 

2 = Square cap 

MiterLimitFactor 

If JoinStyle = 2, UI16 

Miter limit factor as an 8.8 
fixed-point value. 

StartColor 

If HasFillFlag = 0, RGBA 

Color value including alpha 
channel information for start 
shape. 

EndColor 

If HasFillFlag = 0, RGBA 

Color value including alpha 
channel information for end 
shape. 

FillType 

If HasFillFlag =1, 
MORPHFILLSTYLE 

Fill style. 
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CHAPTER 12 

Fonts and Text 



The Macromedia Flash SWF 8 file format specification supports a variety of text-drawing 
primitives. In SWF 6 or later files, all text is represented using Unicode encodings, 
eliminating dependencies on playback locale for text and strings. Note that although Flash 
Player is fully Unicode-enabled, it can only draw left-to-right simple scripts and does not yet 
support Hebrew, Arabic, Thai, or other complex scripts. 

Glyph text and device text 

The SWF file format supports two kinds of text: glyph text and device text. Glyph text works 
by embedding character shapes in the SWF file, while device text uses the text rendering 
capabilities of the playback platform. 

Glyph text looks identical on all playback platforms. It can be drawn with either the standard 
anti-aliasing used by all shapes on a Flash Player Stage, or, in SWF 8 file format and later, 
rendered with FlashType font rendering technology. The usage of glyph text creates larger 
SWF files than for device text, especially in files that use many different characters from a 
large character set. 

Device text is anti-aliased by the operating system that hosts Flash Player, and its appearance 
varies depending on the playback platform. Fonts for device text can be specified in two ways: 
directly, as a font name that will be sought verbatim on the playback platform; or indirectly, 
using one of a small number of special font names that are mapped to highly available fonts 
that differ in name from platform to platform, but are chosen to be as similar in appearance as 
possible across platforms. 


177 



Glyph text characters are defined using the DefineFont, DefineFont2, or DefineFontd tag. 
Device text fonts are defined using the DefineFont and DefineFontInfo tags together, or the 
DefineFont2 tag. DefineFont2 tags for device text fonts do not need to include any character 
glyphs if they will only be used for dynamic text (see next section), although it is a good idea 
to include them if there is any doubt about the specified font being available at playback time 
on any platform. It is possible to use a given DefineFont or DefineFont2 tag as a glyph font 
for certain text blocks, and as a device font for others, as long as both glyphs and character 
codes are provided. 

Static text and dynamic text 

Text can be defined as static text or, in SWF 4 file format or later, dynamic text. Dynamic text 
can be changed programmatically at runtime, and, optionally, can be made editable for 
Macromedia Flash Player users as well. 

Dynamic text can emulate almost all features of static text; exact positioning of individual 
characters is the only advantage of static text, aside from implementation effort and version 
compatibility. Dynamic text also has many formatting capabilities that static text does not 
have. These rich formatting capabilities are expressed as a subset of HTML text-markup tags. 

Static text is defined using the DefineText tag. Dynamic text is defined using the 
DefineEditText tag. Both of these tags make reference to DefineFont or DefineFont2 tags to 
obtain their character sources. DefineEditText tags require DefineFont2 tags rather than 
DefineFont tags; DefineText tags can use either DefineFont or DefineFont2 tags. 

The DefineEditText tag provides a flag that indicates whether to use glyph text or device text. 
However, the DefineText tag does not. This means that, for static text, SWF file format 
provides no means to indicate whether to use glyph text or device text. This situation is 
resolved by runtime flags. Normally, all static text is rendered as glyph text. When a Flash 
Player plug-in is embedded in an HTML page, an HTML tag option called devicefont will 
cause Flash Player to render all static text as device text, if possible; as usual, glyph text is used 
as a fallback. The ability of the DefineEditText tag to specify glyph text or device text is 
another reason to consider dynamic text superior to static text. 
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Glyph text 


Glyph definitions 

Glyphs are defined once in a standard coordinate space called the EM square. The same set of 
glyphs are used for every point size of a given font. To render a glyph at different point sizes, 
Flash Player scales the glyph from EM coordinates to point-size coordinates. 



Glyph fonts—without using FlashType—do not include any hinting information for 
improving the quality of small font sizes. Ffowever, anti-aliasing dramatically improves the 
legibility of scaled-down text. Glyph text remains legible down to about 12 points (viewed at 
100%). At 12 points and lower, FlashType is recommended for readable glyph text. FlashType 
gives superior text quality at small point sizes and includes extra font meta-information for 
improved rendering. 

TrueType fonts can be readily converted to SWF glyphs. A simple algorithm can replace the 
Quadratic fi-splines (used by TrueType fonts) with Quadratic Bezier curves (used by SWF 
glyphs). 

Example: 

To the left is the glyph for the TrueType letter 'b' of Monotype Arial. It is made up of curved 
and straight edges. Squares indicate on-curve points, and crosses indicate off-curve points. 
The black circle is the reference point for the glyph. The blue outline indicates the bounding 
box of the glyph. 
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The EM square 

The EM square is an imaginary square that is used to size and align glyphs. The EM square is 
generally large enough to completely contain all glyphs, including accented glyphs. It 
includes the font’s ascent, descent, and some extra spacing to prevent lines of text from 
colliding. 



SWF glyphs are always defined on an EM square of 1024 by 1024 units. Glyphs from other 
sources (such as TrueType fonts) may be defined on a different EM square. To use these 
glyphs in SWF file format, they should be scaled to fit an EM square of 1024. 

Converting TrueType fonts to SWF glyphs 

TrueType glyphs are defined using Quadratic 5-Splines, which can be easily converted to the 
Quadratic Bezier curves used by SWF glyphs. 

A TrueType 5-spline is composed of one on-curve point, followed by many off-curve points, 
followed by another on-curve point. The midpoint between any two off-curve points is 
guaranteed to be on the curve. A SWF Bezier curve is composed of one on-curve point, 
followed by one off-curve point, followed by another on-curve point. 

The conversion from TrueType to SWF curves involves inserting a new on-curve point at the 
midpoint of two successive off-curve points. 

Example: 

Following is a four point 5-Spline. PO and P3 are on-curve points. PI and P2 are successive 
off-curve points. 
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This curve can be represented as two Quadratic Bezier curves by inserting a new point M, at 
the midpoint of P1,P2. The result is two Quadratic Bezier curves; P0,P1,M and M,P2,P3. 

The complete procedure for converting TrueType glyphs to SWF glyphs is as follows; 

1 . Negate the j/-coordinate. (In TrueType glyphs, the j/-axis points up; in SWF glyphs, the j/- 
axis points down.) 

2 . Scale the x and j co-ordinates from the EM square of the TrueType font, to the EM square 
of the SWF glyph (always 1024). 

3 . Insert an on-curve (anchor) point at the midpoint of each pair of off-curve points. 

Kerning and advance values 

Kerning defines the horizontal distance between two glyphs. Some font systems store kerning 
information along with each font definition. SWF file format, in contrast, stores kerning 
information with every glyph instance (every character in a glyph text block). This is referred 
to as an advance value. 



Advance 


In the preceding example, the A glyph overlaps the V glyph. In this case, the advance is 
narrower than the width of the A glyph. 

FlashType 

Glyph text can be rendered using the normal Flash Player renderer or, in SWF 8 and later, 
with the FlashType system. 

FlashType is a high-quality text renderer supported inside the Flash Player renderer. FlashType 
has the following advantages over using the normal renderer for text: 

■ Readable, even at small point sizes. 

■ Maintains the aesthetic look and feel of a font, even at small point sizes. 

■ Supports pixel snapping for ultra-clear text (when left-aligned dynamic text is used). 

■ Improved performance over glyph text, typically. 

■ LCD sub-pixel rendering when Flash Player detects an LCD screen. 
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A limitation of FlashType, however, is that it does not animate well as compared to glyph text. 

FlashType uses Continuous Stroke Modulation (CSM) parameters to tune its performance. 
CSM is the continuous modulation of both stroke weight and edge sharpness. CSM uses two 
rendering parameters: inside and outside cutoff Optimal values for these parameters are 
highly subjective and can depend on user preferences, lighting conditions, display properties, 
typeface, foreground and background colors, and point size. However, under most 
circumstances, high-quality type can be achieved with a small set of interpolated values. 

The function that creates FlashType edges has an outside cutoff (below which the edge isn’t 
drawn) and an inside cutoff (above which the edge is opaque). Between these two cutoff 
values is a linear function ranging from zero at the outside cutoff to the maximum value at the 
inside cutoff 

Adjusting the outside and inside cutoff values affects stroke weight and edge sharpness. The 
spacing between these two parameters is comparable to twice the filter radius of classic 
anti-aliasing methods: a narrow spacing provides a sharper edge while a wider spacing 
provides a softer, more filtered edge. When the spacing is zero, the resulting density image is a 
bi-level bitmap. When the spacing is very wide, the resulting density image has a watercolor¬ 
like edge. Typically, users prefer sharp, high-contrast edges at small point sizes and softer edges 
for animated text and larger point sizes. 

The outside cutoff typically has a negative value, the inside cutoff typically has a positive 
value, and their midpoint typically lies near zero. Adjusting these parameters to shift the 
midpoint towards negative infinity will increase the stroke weight; shifting the midpoint 
towards positive infinity will decrease the stroke weight. Note that the outside cutoff should 
always be less than or equal to the inside cutoff 

Flash Player creates a table of CSM parameters as a function of text size and text color for each 
FlashType font in use. This default table typically provides a suitable set of CSM settings 
across a wide range of point sizes. However, you can specify a user-defined table to replace the 
default table by using the ActionScript function set Advanced Anti al i asi ngTabl e(). 

z 

o 

H 

m 


The CSM parameters are intended to make fonts more readable and not to create 
effects. Extreme values of CSM result in rendering artifacts. To apply effects to text, it is 
much better to use reasonable CSM values and then apply filters or blend effects. 


DefineFont and DefineText 

Of the four text types supported in SWF file format (static glyph, static device, dynamic 
glyph, and dynamic device), the most complex is static glyph text. The other types use simpler 
variations on the rules used for defining static glyph text. 
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Static glyph text is defined using two tags: 

■ The DefmeFont tag defines a set of glyphs. 

■ The DefineText tag defines the text string that is displayed in the font. 

The DefmeFont tag defines all the glyphs used by subsequent DefineText tags. DefineFont 
includes an array of SHAPERECORDs, which describe the outlines of the glyphs. These 
shape records are the same records used by DefineShape to define non-text shapes. To keep 
file size to a minimum, only the glyphs actually used are included in the DefineFont tag. 

The DefineText tag stores the actual text string(s) to be displayed, represented as a series of 
glyph indices. It also includes the bounding box of the text object, a transformation matrix, 
and style attributes such as color and size. 

DefineText contains an array of TEXTRECORDs. A TEXTRECORD selects the current 
font, color, and point size, as well as the x and j position of the next character in the text. 
These styles apply to all characters that follow, until another TEXTRECORD changes the 
styles. A TEXTRECORD also contains an array of indices into the glyph table of the current 
font. Characters are not referred to by their character codes, as in traditional programming, 
but rather by an index into the glyph table. The glyph data also includes the advance value for 
each character in the text string. 

A DefineFont tag must always come before any DefineText tags that refer to it. 



Static glyph text example 

Consider the example of displaying the static glyph text bob in the Arial font, with a point size 
of 24. 

First, define the glyphs with a DefineFont tag. The glyph table, of type SFIAPE, has two 
SHAPERECORDs. At index 0 is the shape of a lowercase b (see diagram). At index 1 is the 
shape of a lowercase o. (The second b in bob is a duplicate, and is not required). DefineFont 
also includes a unique ID so it can be selected by the DefineText tag. 

Next, define the text itself with a DefineText tag. The TEXTRECORD sets the position of 
the first character, selects the Arial font (using the font’s character ID), and sets the point size 
to 24, so the font is scaled to the correct size. (Remember that glyphs are defined in EM 
coordinates—the actual point size is part of the DefineText tag). It also contains an array of 
GLYPHENTRYs. Each glyph entry contains an index into the font’s shape array. In this 
example, the first glyph entry has index 0 (which corresponds to the b shape), the second 
entry has index 1 (the o), and the third entry has index 0 {b again). Each GLYPHENTRY also 
includes an advance value for accurately positioning the glyph. 
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The following diagram illustrates how the DefineText tag interacts with the DefmeFont tag: 


DefineFont DefineText 

SHAPE Array: TEXTRECORD 



Font tags 

DefineFont 

The DefmeFont tag defines the shape outlines of each glyph used in a particular font. Only 
the glyphs that are used by subsequent DefineText tags are actually defined. 

DefineFont tags cannot be used for dynamic text. Dynamic text requires the DefineFont2 tag. 
The minimum file format version is SWF 1. 

DefineFont 


Field 

Type 

Comment 

Header 

RECORDHEADER 

Tag type = 10 

FontID 

UI16 

ID for this font character 

OffsetTable 

UI16[nGlyphs] 

Array of shape offsets 

GlyphShapeTable 

SHAPE[nGlyphs] 

Array of shapes 


The font ID uniquely identifies the font. It can be used by subsequent DefineText tags to 
select the font. Like all SWF character IDs, font IDs must be unique among all character IDs 
in a SWF file. 


If you provide a DefineFontInfo tag to go along with a DefineFont tag, be aware that the 
order of the glyphs in the DefineFont tag must match the order of the character codes in the 
DefineFontInfo tag, which must be sorted by code point order. 
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The OffsetTable and GlyphShapeTable are used together. These tables have the same number 
of entries, and there is a one-to-one ordering match between the order of the offsets and the 
order of the shapes. The OffsetTable points to locations in the GlyphShapeTable. Each offset 
entry stores the difference (in bytes) between the start of the offset table and the location of 
the corresponding shape. Because the GlyphShapeTable immediately follows the OffsetTable, 
the number of entries in each table (the number of glyphs in the font) can be inferred by 
dividing the first entry in the OffsetTable by two. 

The first STYLECHANGEREGORD of each SHAPE in the GlyphShapeTable does not use 
the LineStyle and LineStyles fields. In addition, the first STYLEGHANGEREGORD of each 
shape must have both fields StateFillStyleO and FillStyleO set to 1. 

DefineFontInfo 

The DefineFontInfo tag defines a mapping from a glyph font (defined with DefineFont) to a 
device font. It provides a font name and style to pass to the playback platform’s text engine, 
and a table of character codes that identifies the character represented by each glyph in the 
corresponding DefineFont tag, allowing the glyph indices of a DefineText tag to be converted 
to character strings. 

The presence of a DefineFontInfo tag does not force a glyph font to become a device font; it 
merely makes the option available. The actual choice between glyph and device usage is made 
according to the value of devicefont (see the introduction) or the value of UseOutlines in a 
DefineEditText tag. If a device font is unavailable on a playback platform. Flash Player will 
fall back to glyph text. 
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The minimum file format version is SWF 1. 


DefineFontInfo 

Field 

Type 

Comment 

Header 

RECORDHEADER 

Tag type = 13. 

FontID 

UI16 

Font ID this Information Is for. 

FontNameLen 

UI8 

Length of font name. 

FontName 

UI8[FontNameLen] 

Name of the font (see 
following). 

FontFlagsReserved 

UB[2] 

Reserved bit fields. 

FontFlagsSmallT ext 

UB[1] 

SWF 7 file format or later: 

Font Is small. Character glyphs 
are aligned on pixel boundaries 
for dynamic and input text. 

FontFlagsShiftJIS 

UB[1] 

ShiftJIS character codes. 

FontFlagsANSI 

UB[1] 

ANSI character codes. 

FontFlagsItalic 

UB[1] 

Font Is Italic. 

FontFlagsBold 

UB[1] 

Font Is bold. 

FontFlagsWideCodes 

UB[1] 

If 1, CodeTable Is UI16 array; 
otherwise, CodeTable is UI8 
array. 

CodeTable 

If FontFlagsWideCodes 
UI16[nGlyphs] 

Otherwise UI8[nGlyphs] 

Glyph to code table, sorted In 
ascending order. 


The entries in the CodeTable must be sorted in ascending order by code point, by the value 
they provide. The order of the entries in the CodeTabl e must also match the order of the 
glyphs in the DefineFont tag to which this DefineFontInfo tag applies. This places a 
requirement on the ordering of glyphs in the corresponding DefineFont tag. 
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SWF 6 or later files require Unicode text encoding. One aspect of this requirement is that all 
character code tables are specified using UCS-2 (UCS-2 is generally the first 64k code points 
of UTF-16). This encoding uses a fixed 2 bytes for each character. This means that when a 
DefmeFontInfo tag appears in a SWF 6 or later file, FontFlagsWideCodes must be set, 
FontFlagsShiftJIS and FontFlagsANSI must be cleared, and CodeTable must consist of UI16 
entries (as always, in little-endian byte order) encoded in UCS-2. 

Another Unicode requirement that applies to SWF 6 or later files is that font names must 
always be encoded using UTF-8. In SWF 5 or earlier files, font names are encoded in a 
platform-specific way, in the codepage of the system on which they were authored. The 
playback platform will interpret them using its current codepage, with potentially inconsistent 
results. If the playback platform is an ANSI system, font names will be interpreted as ANSI 
strings. If the playback platform is a Japanese shift-JIS system, font names will be interpreted 
as shift-JIS strings. Many other values for the playback platform’s codepage, which governs this 
decision, are possible. This playback locale dependency is undesirable, which is why SWF 6 
file format moved toward a standard encoding for font names. Note that font name strings in 
the DefmeFontInfo tag are not null-terminated; instead their length is specified by the 
FontNameLen field. FontNameLen specifies the number of bytes in FontName, which is not 
necessarily equal to the number of characters, since some encodings may use more than one 
byte per character. 

Font names are normally used verbatim, passed directly to the playback platform’s font system 
in order to locate a font. However, there are several special indirect font names that are 
mapped to different actual font names depending on the playback platform. These indirect 
mappings are hard-coded into each platform-specific port of Flash Player, and the fonts for 
each platform are chosen from among system default fonts or other fonts that are very likely 
to be available. As a secondary consideration, the indirect mappings are chosen so as to 
maximize the similarity of indirect fonts across platforms. 
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The following tables describe the indirect font names that are supported. 

Western indirect fonts 


Font name 

Example 


_sans 

Hello world 


_serif 

Hello world 


typewriter 

Flel 1 0 worl d 


Japanese indirect fonts 


Font name: 

English Name: 

UTF-8 Byte String (hex) 

Example appearance: 

Font name: 

English Name: 

UTF-8 Byte String (hex) 

Example appearance: 

Font name: 

English Name: 

UTF-8 Byte String (hex) 

Example appearance: 

DefineFontlnfo2 

When generating SWF 6 or later, it is recommended that you use the new DefmeFontInfo2 
tag rather than DefineFontlnfo. DefineFontInfo2 is identical to DeflneFontlnfo, except that 
it adds a field for a language code. If you use the older DefineFontlnfo, the language code will 
be assumed to be zero, which results in behavior that is dependent on the locale in which 
Flash Player is running. 


Mincho 

5F E6 98 8E E6 9C 9D 


Tohaba (Gothic Mono) 

5E E7 AD 89 E5 B9 85 

CA,Ai, 


Gothic 

5E E3 82 B4 E3 82 B7 E3 83 83 E3 82 AF 
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The minimum file format version is SWF 6. 


DefineFontlnfo2 



Field 

Type 

Comment 

Header 

RECORDHEADER 

Tag type = 62. 

FontID 

UI16 

Font ID this information is for. 

FontNameLen 

UI8 

Length of font name. 

FontName 

UI8[FontNameLen] 

Name of the font. 

FontFlagsReserved 

UB[2] 

Reserved bit fields. 

FontFlagsSmallT ext 

UB[1] 

SWF 7 or later: 

Font is small. Character glyphs 
are aligned on pixel boundaries 
for dynamic and input text. 

FontFlagsShiftJIS 

UB[1] 

Always 0. 

FontFlagsANSI 

UB[1] 

Always 0. 

FontFlagsItalic 

UB[1] 

Font is italic. 

FontFlagsBold 

UB[1] 

Font is bold. 

FontFlagsWideCodes 

UB[1] 

Always 1. 

LanguageCode 

LANGCODE 

Language ID. 

CodeTable 

UI16[nGlyphs] 

Glyph to code table in UCS-2, 
sorted in ascending order. 


DefineFont2 

The DefineFont2 tag extends the functionality of DefineFont. Enhancements include 
the following: 

■ 32-bit entries in the OffsetTable, for fonts with more than 64K glyphs. 

■ Mapping to device fonts, by incorporating all the functionality of DefineFontInfo. 

■ Font metrics for improved layout of dynamic glyph text. 

DefineFont2 tags are the only font definitions that can be used for dynamic text. 
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The minimum file format version is SWF 3. 


DefineFont2 



Field 

Type 

Comment 

Header 

RECORDHEADER 

Tag type = 48. 

FontID 

UI16 

ID for this font character. 

FontFlagsHasLayout 

UB[1] 

Has font metrics/layout 
information. 

FontFlagsShiftJIS 

UB[1] 

ShiftJIS encoding. 

FontFlagsSmallT ext 

UB[1] 

SWF 7 or later: 

Font is small. Character glyphs 
are aligned on pixel boundaries 
for dynamic and input text. 

FontFlagsANSI 

UB[1] 

ANSI encoding. 

FontFlagsWideOffsets 

UB[1] 

If 1, uses 32 bit offsets. 

FontFlagsWideCodes 

UB[1] 

If 1, font uses 16-bit codes; 
otherwise font uses 8 bit codes. 

FontFlagsItalic 

UB[1] 

Italic Font. 

FontFlagsBold 

UB[1] 

Bold Font. 

LanguageCode 

LANGCODE 

SWF 5 or earlier: 
always 0 

SWF 6 or later: 
language code 

FontNameLen 

UI8 

Length of name. 

FontName 

UI8[FontNameLen] 

Name of font (see 
DefineFontInfo). 

NumGlyphs 

UI16 

Count of glyphs in font. 

May be zero for device fonts. 

OffsetTable 

If FontFlagsWideOffsets 
UI32[NumGlyphs] 

Otherwise UI16[NumGlyphs] 

Same as in DefineFont. 

CodeT ableOffset 

If FontFlagsWideOffsets 
UI32 

Otherwise UI16 

Byte count from start of 
OffsetTable to start of 

CodeTable. 

GlyphShapeTable 

SHAPE[NumGlyphs] 

Same as in DefineFont. 
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DefineFont2 

Field 

Type 

Comment 

CodeTable 

If FontFlagsWideCodes 
UI16[NumGlyphs] 

Otherwise UI8[NumGlyphs] 

Sorted in ascending order. 
Always UCS-2 in SWF 6 or 
later. 

FontAscent 

If FontFlagsHasLayout SI16 

Font ascender height. 

FontDescent 

If FontFlagsHasLayout SI16 

Font descender height. 

FontLeading 

If FontFlagsHasLayout SI16 

Font leading height (see 
following). 

FontAdvanceTable 

If FontFlagsHasLayout 
SI16[NumGlyphs] 

Advance value to be used for 
each glyph in dynamic glyph 
text. 

FontBoundsTable 

If FontFlagsHasLayout 
RECT[NumGlyphs] 

Not used in Flash Player 
through version 7 (but must be 
present). 

KerningCount 

If FontFlagsHasLayout LII16 

Not used in Flash Player 
through version 7 (always set to 
0 to save space). 

FontKerningTable 

If FontFlagsHasLayout 

KERNINGRECORD 

[KerningCount] 

Not used in Flash Player 
through version 7 (omit with 
KerningCount of 0). 


In SWF 6 or later files, DefineFont2 has the same Unicode requirements as DefineFontInfo. 
Similarly to the DefineFontInfo tag, the CodeTable (and thus also the OffsetTable, 
GlyphShapeTable, and FontAdvanceTable) must be sorted in code point order. 

If a DefmeFont2 tag will be used only for dynamic device text, and no glyph-rendering 
fallback is desired, set NumGlyphs to zero, and omit all tables having NumGlyphs entries. 
This will substantially reduce the size of the DefmeFont2 tag. DefmeFont2 tags without 
glyphs cannot support static text, which uses glyph indices to select characters, and also 
cannot support glyph text, which requires glyph shape definitions. 
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Layout information (ascent, descent, leading, advance table, bounds table, kerning table) is 
useful only for dynamic glyph text. This information takes the place of the per-character 
placement information that is used in static glyph text. The layout information in the 
DefmeFont2 tag is fairly standard font-metrics information that can typically be extracted 
directly from a standard font definition, such as a TrueType font. 

Leading is a vertical line-spacing metric. It is the distance (in EM-square coordinates) 
between the bottom of the descender of one line and the top of the ascender of the next 
line. 

As with DefineFont, in DefmeFont2 the first STYLECHANGERECORD of each SFIAPE in 
the GlyphShapeTable does not use the LineStyle and LineStyles fields. In addition, the first 
STYLEGFIANGEREGORD of each shape must have both fields StateFillStyleO and 
FillStyleO set to 1. 

The DefineFont2 tag reserves space for a font bounds table and kerning table. This 
information is not used in Flash Player through version 7. Fiowever, this information must be 
present in order to constitute a well-formed DefineFont2 tag. Supply minimal (low-bit) 
REGTs for FontBoundsTable, and always set KerningGount to zero, which allows 
FontKerningTable to be omitted. 

DefineFontS 

The DefineFont3 tag is introduced along with the DefineFontAlignZones tag in SWF 8. The 
DefineFontAlignZones tag is optional but recommended for SWF files using FlashType, and 
it modifies the DefineFont3 tag. 

The DefineFont3 tag extends the functionality of DefineFont2 by expressing the SFIAPE 
coordinates in the GlyphShapeTable at 20 times the resolution. All the EMSquare coordinates 
are multiplied by 20 at export, allowing fractional resolution to 1/20 of a unit. This allows for 
more precisely defined glyphs and results in better visual quality. 

The minimum file format version is SWF 8. 


DefineFontS 



Field 

Type 

Comment 

Header 

RECORDHEADER 

Tag type = 75. 

FontID 

UI16 

ID for this font character. 

FontFlagsHasLayout 

UB[1] 

Has font metrics/layout 
information. 

FontFlagsShiftJIS 

UB[1] 

ShiftJIS encoding. 


z 

o 

H 

m 
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DefineFontS 



Field 

Type 

Comment 

FontFlagsSmallT ext 

UB[1] 

SWF 7 or later: 

Font is small. Character glyphs 
are aligned on pixel boundaries 
for dynamic and input text. 

FontFlagsANSI 

UB[1] 

ANSI encoding. 

FontFlagsWideOffsets 

UB[1] 

If 1, uses 32 bit offsets. 

FontFlagsWideCodes 

UB[1] 

Must be 1. 

FontFlagsItalic 

UB[1] 

Italic Font. 

FontFlagsBold 

UB[1] 

Bold Font. 

LanguageCode 

LANGCODE 

SWF 5 or earlier: 
always 0 

SWF 6 or later: 
language code 

FontNameLen 

UI8 

Length of name. 

FontName 

UI8[FontNameLen] 

Name of font (see 
DefineFontInfo). 

NumGlyphs 

UI16 

Count of glyphs in font. 

May be zero for device fonts. 

OffsetTable 

If FontFlagsWideOffsets 
UI32[NumGlyphs] 

Otherwise UI16[NumGlyphs] 

Same as in DefineFont. 

CodeT ableOffset 

If FontFlagsWideOffsets 
UI32 

Otherwise UI16 

Byte count from start of 
OffsetTable to start of 

CodeTable. 

GlyphShapeTable 

SHAPE[NumGlyphs] 

Same as in DefineFont. 

CodeTable 

UI16[NumGlyphs] 

Sorted in ascending order. 
Always LICS-2 in SWF 6 or 
later. 

FontAscent 

If FontFlagsHasLayout SI16 

Font ascender height. 

FontDescent 

If FontFlagsHasLayout SI16 

Font descender height. 

FontLeading 

If FontFlagsHasLayout SI16 

Font leading height (see 
following). 
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DefineFontS 

Field 

Type 

Comment 

FontAdvanceTable 

If FontFlagsHasLayout 
SI16[NumGlyphs] 

Advance value to be used for 
each glyph in dynamic glyph 
text. 

FontBoundsTable 

If FontFlagsHasLayout 
RECT[NumGlyphs] 

Not used in Flash Player 
through version 7 (but must be 
present). 

KerningCount 

If FontFlagsHasLayout LII16 

Not used in Flash Player 
through version 7 (always set to 

0 to save space). 

FontKerningTable 

If FontFlagsHasLayout 

KERNINGRECORD 

[KerningCount] 

Not used in Flash Player 
through version 7 (omit with 
KerningCount of 0). 


DefineFontAlignZones 

The DefmeFont3 tag can be modified by a DefineFontAlignZones tag. FlashType uses 
alignment zones to establish the borders of a glyph for pixel snapping. Alignment zones are 
critical for high-quality display of fonts. 

The alignment zone defines a bounding box for strong vertical and horizontal components of 
a glyph. The box is described by a left coordinate, thickness, baseline coordinate, and height. 
Small thicknesses or heights are often set to 0. 

For example, consider the letter /. The letter / has a strong horizontal at its baseline and the 
top of the letter. The letter I also has strong verticals that occur at the edges of the stem—not 
the short top bar or serif. These strong verticals and horizontals of the center block of the 
letter define the alignment zones. 

y range (height) 

■- .Mignment Zone 

X (left) H X range (thickness) 

y (baseline) 
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The minimum file format version is SWF 8. 


DefineFontAlignZones 



Field 

Type 

Comment 

Header 

RECORDHEADER 

Tag type = 73. 

FontID 

UI16 

ID of font to use, specified by 
DefineFontS. 

CSMTableHint 

UB[2] 

Font thickness hint. Refers 
to the thickness of the typical 
stroke used in the font. 

0 = thin 

1 = medium 

2 = thick 

Flash Player maintains a 
selection of CSM tables for 
many fonts. However, if the 
font is not found in Flash 
Player's internal table, this 
hint is used to choose an 
appropriate table. 

Reserved 

UB[6] 

Must be 0. 

ZoneTable 

ZONERECORD[eiyphCount] 

Alignment zone information 
for each glyph. 


ZONERECORD 


Field 

Type 

Comment 

NumZoneData 

UI8 

Number of ZoneData entries. 
Always 2. 

ZoneData 

ZONEDATA[NumZoneData] 

Compressed alignment zone 
information. 

ZoneMaskX 

UB[1] 

Set if there are X alignment 

zones. 

ZoneMaskY 

UB[1] 

Set if there are Y alignment 

zones. 

Reserved 

UB[6] 

Must be 0. 
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ZONEDATA 



Field 

Type 

Comment 

AlignmentCoordinate 

FLO ATI 6 

X (left) or Y (baseline) 
coordinate of the alignment 



zone. 

Range 

FLOAT16 

Width or height of the 
alignment zone. 


Kerning record 

A Kerning Record defines the distance between two glyphs in EM square coordinates. Certain 
pairs of glyphs appear more aesthetically pleasing if they are moved closer together, or farther 
apart. The FontKerningCodel and FontKerningCode2 fields are the character codes for the 
left and right characters. The FontKerningAdjustment field is a signed integer that defines a 
value to be added to the advance value of the left character. 


KERNINGRECORD 



Field 

Type 

Comment 

FontKerningCodel 

If FontFlagsWideCodes UI16 
Otherwise UI8 

Character code of the left 
character. 

FontKerningCode2 

If FontFlagsWideCodes UI16 
Otherwise UI8 

Character code of the right 
character. 

FontKerningAdjustment 

SI16 

Adjustment relative to left 
character’s advance value. 


Static text tags 

DefineText 

The DefineText tag defines a block of static text. It describes the font, size, color, and exact 
position of every character in the text object. 
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The minimum file format version is SWF 1. 


DefineText 

Field 

Type 

Comment 

Header 

RECORDHEADER 

Tag type = 11. 

CharacterlD 

UI16 

ID for this text character. 

TextBounds 

RECT 

Bounds of the text. 

TextMatrix 

MATRIX 

Transformation matrix for the 

text. 

GlyphBits 

UI8 

Bits in each glyph index. 

AdvanceBits 

UI8 

Bits in each advance value. 

TextRecords 

TEXTRECORD[zero or more] 

Text records. 

EndOfRecordsFlag 

UI8 

Must be 0. 


The TextBounds field is the rectangle that completely encloses all the characters in this text 
block. 


The GlyphBits and AdvanceBits fields define the number of bits used for the Glyphindex and 
GlyphAdvance fields, respectively, in each GLYPHENTRY record. 


Text records 

A TEXTRECORD sets text styles for subsequent characters. It can be used to select a font, 
change the text color, change the point size, insert a line break, or set the x and y position of 
the next character in the text. The new text styles apply until another TEXTREGORD 
changes the styles. 
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The TEXTRECORD also defines the actual characters in a text object. Characters are 
referred to by an index into the current font’s glyph table, not by a character code. Each 
TEXTRECORD contains a group of characters that all share the same text style, and are on 
the same line of text. 

TEXTRECORD 


Field 

Type 

Comment 

T extRecordT ype 

UB[1] 

Always 1. 

StyleFlagsReserved 

UB[3] 

Always 0. 

StyleFlagsHasFont 

UB[1] 

1 if text font specified. 

StyleFlagsHasColor 

UB[1] 

1 if text color specified. 

StyleFlagsHasYOffset 

UB[1] 

1 if y offset specified. 

StyleFlagsHasXOffset 

UB[1] 

1 if X offset specified. 

FontID 

If StyleFlagsHasFont UI16 

Font ID for following text. 

TextColor 

If StyleFlagsHasColor RGB 

If this record is part of a 
DefineText2 tag then RGBA 

Font color for following text. 

XOffset 

If StyleFlagsHasXOffset SI16 

X offset for following text. 

YOffset 

If StyleFlagsHasYOffset SI16 

y offset for following text. 

TextHeight 

If hasFont UI16 

Font height for following text. 

GlyphCount 

UI8 

Number of glyphs in record. 

GlyphEntries 

GLYPHENTRY[GlyphCount] 

Glyph entry (see following). 


The Font ID field is used to select a previously defined font. This ID uniquely identifies a 
DefineFont or DefineFont2 tag from earlier in the SWF file. 

The TextHeight field defines the height of the font in twips. For example, a pixel height of 50 
is equivalent to a TextHeight of 1000. (50 * 20 = 1000). 

The XOffset field defines the offset from the left of the TextBounds rectangle to the reference 
point of the glyph (the point within the EM square from which the first curve segment 
departs). Typically, the reference point is on the baseline, near the left side of the glyph (see 
the example for Glyph text). The XOffset is generally used to create indented text or non-left- 
justified text. If there is no XOffset specified, the offset is assumed to be zero. 

The YOffset field defines the offset from the top of the TextBounds rectangle to the reference 
point of the glyph. The TextYOffset is generally used to insert line breaks, moving the text 
position to the start of a new line. 
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The GlyphCount field defines the number of characters in this string, and the size of the 
GLYPHENTRY table. 

Glyph entry 

The GLYPHENTRY structure describes a single character in a line of text. It is composed of 
an index into the current font’s glyph table, and an advance value. The advance value is the 
horizontal distance between the reference point of this character and the reference point of the 
following character. 


GLYPHENTRY 



Field 

Type 

Comment 

Glyphindex 

UB[GlyphBits] 

Glyph index into current font. 

GlyphAdvance 

SB[AdvanceBits] 

X advance value for glyph. 


DefineText2 

The DefineText2 tag is almost identical to the DefineText tag. The only difference is that 
Type 1 text records contained within a DefineText2 tag use an RGBA value (rather than an 
RGB value) to define TextColor. This allows partially or completely transparent characters. 

Text defined with DefineText2 is always rendered with glyphs. Device text can never 
include transparency. 

The minimum file format version is SWF 3. 

DefineText2 

Field Type Comment 

Header 
CharacterlD 
TextBounds 
TextMatrix 
GlyphBits 
AdvanceBits 
TextRecords 
EndOfRecordsFlag 


RECORDHEADER 

UI16 

RECT 

MATRIX 

UI8 

UI8 


Tag type = 33. 

ID for this text character. 
Bounds of the text. 
Transformation matrix. 

Bits in each glyph index. 
Bits in each advance value. 


TEXTRECORD[zero or more] Text records. 
UI8 Must be 0. 
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Dynamic text tags 


DefineEditText 

The DefineEditText tag defines a dynamic text object, or text field. 

A text field is associated with an ActionScript variable name where the contents of the text 
field are stored. The SWF file can read and write the contents of the variable, which is always 
kept in sync with the text being displayed. If the ReadOnly flag is not set, users may change 
the value of a text field interactively. 

Fonts used by DefineEditText must be defined using DefmeFont2, not DefineFont. 

The minimum file format version is SWF 4. 


DefineEditText 



Field 

Type 

Comment 

Header 

RECORDHEADER 

Tag type = 37. 

CharacterlD 

UI16 

ID for this dynamic text 
character. 

Bounds 

RECT 

Rectangle that completely 
encloses the text field. 

HasText 

UB[1] 

0 = text field has no default text. 

1 = text field initially displays the 
string specified by InitialText. 

Wordwrap 

UB[1] 

0 = text will not wrap and will 
scroll sideways. 

1 = text will wrap automatically 
when the end of line is reached. 

Multiline 

UB[1] 

0 = text field is one line only. 

1 = text field is multi-line and 

scrollable. 

Password 

UB[1] 

0 = characters are displayed as 
typed. 

1 = all characters are displayed 
as an asterisk. 

Readonly 

UB[1] 

0 = text editing is enabled. 

1 = text editing is disabled. 
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DefineEditText 

Field 

Type 

Comment 

HasTextColor 

UB[1] 

0 = use default color. 

1 = use specified color 
(TextColor). 

HasMaxLength 

UB[1] 

0 = length of text is unlimited. 

1 = maximum length of string is 
specified by MaxLength. 

HasFont 

UB[1] 

0 = use default font. 

1 = use specified font (FontID) 
and height (FontHeight). 

Reserved 

UB[1] 

Always 0. 

AutoSize 

UB[1] 

0 = fixed size. 

1 = sizes to content (SWF 6 or 
later only). 

Has Layout 

UB[1] 

Layout information provided. 

NoSelect 

UB[1] 

Enables or disables interactive 

text selection. 

Border 

UB[1] 

Causes a border to be drawn 
around the text field. 

Reserved 

UB[1] 

Always 0. 

HTML 

UB[1] 

0 = plaintext content. 

1 = HTML content (see 
following). 

UseOutlines 

UB[1] 

0 = use device font. 

1 = use glyph font. 

FontID 

If HasFont UI16 

ID of font to use. 

FontHeight 

If HasFont UI16 

Height of font in twips. 

TextColor 

If HasTextColor RGBA 

Color of text. 

MaxLength 

If HasMaxLength UI16 

Text is restricted to this length. 

Align 

If HasLayout LII8 

0 = Left 

1 = Right 

2 = Center 

3 = Justify 

LeftMargin 

If HasLayout LII16 

Left margin in twips. 

RightMargin 

If HasLayout LII16 

Right margin in twips. 
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DefineEditText 

Field 

Type 

Comment 

Indent 

If HasLayout UI16 

Indent in twips. 

Leading 

If HasLayout SI16 

Leading in twips (vertical 
distance between bottom of 
descender of one line and top of 
ascender of the next). 

VariableName 

STRING 

Name of the variable where the 

contents of the text field are 
stored. May be qualified with 
dot syntax or slash syntax for 
non-global variables. 

InitialText 

If HasText STRING 

Text that is initially displayed. 


If the HTML flag is set, the contents of InitialText are interpreted as a limited subset of the 
HTML tag language, with a few additions not normally present in HTML. The following 
tags are supported: 


Tag Description 

<p> ... </p> Defines a paragraph. The attribute align may be present, with 

value left, right, or center. 

<br> Inserts a line break. 

<a> ... </a> Defines a hyperlink. The attribute href must be present. The 

attribute target is optional, and specifies a window name. 

<font> ... </font> Defines a span of text that uses a given font. The following 

attributes are available: 

• face, which specifies a font name that must match a font 
name supplied in a DefineFont2 tag 

• s i ze, which is specified in twips, and may include a leading 
'+’ or for relative sizes 

• color, which is specified as a #RRGGBB hex triplet 


<b> . . 

. </b> 

Defines a span of bold text. 

<i> . . 

. </i> 

Defines a span of italic text. 

<u> . . 

. </u> 

Defines a span of underlined text. 

<li> . 

.. </li> 

Defines a bulleted paragraph. The <ul> tag is not necessary and 
is not supported. Numbered lists are not supported. 
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Tag 

Description 

<textformat> ... </ 
textformat> 

Defines a span of text with certain formatting options. The 
following attributes are available: 

• 1 eftmargi n, which specifies the left margin in twips 

• rightmargi n, which specifies the right margin in twips 

• 1 ndent, which specifies the left indent in twips 

• bl ocki ndent, which specifies a block indent in twips 

• 1 eadi ng, which specifies the leading in twips 

• tabstops, which specifies a comma-separated list of tab 
stops, each specified in twips 

<tab> 

Inserts a tab character, which advances to the next tab stop as 
defined with the <textformat> tag. 


CSMT extSettings 

In addition to FlashType tags discussed earlier in this chapter, FlashType also supports a tag 
for modifying text fields. The CSMTextSettings tag modifies a previously streamed 
DefineText, DefineText2, or DefineEditText tag. The CSMTextSettings tag turns FlashType 
on or off for a text field, and can also be used to define FlashType quality and options. 

The minimum file format version is SWF 8. 


CSMTextSettings 

Field Type Comment 


Header 

TextID 


UseFlashType 


RECORDHEADER Tag type = 74. 

UI16 ID for the DefineText, 

DefineText2, or 
DefineEditText to which this 
tag applies. 

UB[2] 0 = use normal renderer. 

1 = use FlashType renderer. 
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CSMTextSettings 



Field 

Type 

Comment 

GridFit 

UB[3] 

0 = Do not use grid fitting. 
AlignmentZones and LCD 
sub-pixel information will not 
be used. 

1 = Pixel grid fit. Only 
supported for left-aligned 
dynamic text. This setting 
provides the ultimate in 
FlashType readability, with 
crisp letters aligned to pixels. 

2 = Sub-pixel grid fit. Align 
letters to the 1/3 pixel used 
by LCD monitors. Can also 
improve quality for CRT 
output. 

Reserved 

UB[3] 

Must be 0. 

Thickness 

F32 

The thickness attribute for 

the associated text field. Set 

to 0.0 to use the default 
(anti-aliasing table) value. 

Sharpness 

F32 

The sharpness attribute for 
the associated text field. Set 

to 0.0 to use the default 
(anti-aliasing table) value. 

Reserved 

UI8 

Must be 0. 


The Thickness and Sharpness fields are interpretations of the CSM parameters, applied to a 
particular text field. The thickness and sharpness setting will override the default CSM setting 
for that text field. 

The CSM parameters, at render time, are computed from the thickness and sharpness: 

outsideCutoff = (0.5f * sharpness - thickness) * fontSize; 
insideCutoff = (-0.5f * sharpness - thickness) * fontSize; 

Using the font size in the cutoff calculations results in linear scaling of CSM parameters, and 
linear scaling tends to be a poor approximation when significant scaling is applied. When a 
text field will scale, it is usually better to use the default table or provide your own anti¬ 
aliasing table. 
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CHAPTER 13 

Sounds 


13 


The Macromedia Flash SWF 8 file format specification defines a small and efficient sound 
model. The SWF file format supports sample rates of 5.5, 11, 22, and 44 kHz in both stereo 
and mono. Macromedia Flash Player supports rate conversion and multichannel mixing of 
these sounds. The number of simultaneous channels supported depends on the CPU of 
specific platforms, but is typically three to eight channels. 

There are two types of sounds in SWF file format: 

■ Event sounds 

■ Streaming sounds 

Event sounds are played in response to some event such as a mouse click, or when Flash Player 
reaches a certain frame. Event sounds must be defined (downloaded) before they are used. 
They can be reused for multiple events if desired. Event sounds may also have a sound “style” 
that modifies how the basic sound is played. 

Streaming sounds are downloaded and played in tight synchronization with the timeline. In 
this mode, sound packets are stored with each frame. 

O 
H 

m 


"5.5 kHz" = 5512 Hz 

"11 kHz" = 11025 Hz 

"22 kHz" = 22050 Hz 

"44 kHz" = 44100 Hz 

For information on including audio in the FLV File Format, please refer to the FLV Audio 
Tags section. 


— 

The exact sample rates used are as follows. These are standard sample rates based on 
CD audio, which Is sampled at 44100 Hz. The four sample rates are one-eighth, one- 
quarter, one-half, and exactly the 44100 Hz sampling rate. 
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Event sounds 

There are three tags required to play an event sound: 

■ The tag DefineSound provides the audio samples that make up an event sound. 

■ The record SOUNDINFO defines the styles that are applied to the event sound. Styles 
include fade-in, fade-out, synchronization and looping flags, and envelope control. 

■ The tag StartSound instructs Flash Player to begin playing the sound. 


DefineSound 

The DefineSound tag defines an event sound. It includes the sampling rate, size of each 
sample (8 or 16 bit), a stereo/mono flag, and an array of audio samples. The audio data may 
be stored in four ways: 

■ As uncompressed raw samples. 

■ Compressed using an ADPCM algorithm. 

■ Compressed using MP3 compression (SWF 4 file format or later only). 

■ Compressed using the Nellymoser Asao codec (SWF 6 file format or later only). 

The minimum file format version is SWF 1. 


Define Sound 

Field 

Type 

Comment 

Header 

RECORDHEADER 

Tag type = 14 

Soundid 

UI16 

ID for this sound. 

SoundFormat 

UB[4] 

Format of SoundData: 

0 = uncompressed 

1 = ADPCM 

SWF 4 or later only: 

2 = MP3 

3 = uncompressed little-endian 
SWF 6 or later only: 

6 = Nellymoser 

SoundRate 

UB[2] 

The sampling rate. 

5.5kHz is not allowed for MP3. 

0 = 5.5 kHz 

1 = 11 kHz 

2 = 22 kHz 

3 = 44 kHz 
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Define Sound 
Field 

SoundSize 


SoundType 


SoundSampleCount 


SoundData 


Type Comment 

UB[1] Size of each sample. Always 16 

bit for compressed formats. 
May be 8 or 16 bit for 
uncompressed formats. 

0 = sndSBit 
1 = snd16Bit 

UB[1] Mono or stereo sound 

For Nellymoser: always 0 
0 = sndMono 
1 = sndStereo 

UI32 Number of samples. Not 

affected by mono/stereo 
setting; for stereo sounds this is 
the number of sample pairs. 

UI8[size of sound data] The sound data; varies by 

format. 


The Soundid field uniquely identifies the sound so it can be played by StartSound. 

Format 0 (uncompressed) and Format 3 (uncompressed little-endian) are similar. Both 
encode uncompressed audio samples. For 8-bit samples, the two formats are identical. For 16- 
bit samples, the two formats differ in byte ordering. In Format 0, 16-bit samples are encoded 
and decoded according to the native byte ordering of the platform on which the encoder and 
Flash Player, respectively, are running. In Format 3, 16-bit samples are always encoded in 
little-endian order (least significant byte first), and are byte-swapped if necessary in Flash 
Player before playback. Format 0 is clearly disadvantageous because it introduces a playback 
platform dependency. For 16-bit samples. Format 3 is highly preferable to Format 0 for SWF 
4 or later. 

The contents of SoundData vary depending on the value of the SoundFormat field in the 
SoundStreamHead tag: 

■ If SoundFormat is 0 or 3, SoundData contains raw, uncompressed samples. 

■ If SoundFormat is 1, SoundData contains an ADPCM sound data record. 

■ If SoundFormat is 2, SoundData contains an MP3 sound data record. 

■ If SoundFormat is 6, SoundData contains Nellymoser data (see Nellymoser compression). 
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StartSound 


StartSound is a control tag that either starts (or stops) playing a sound defined by 
DefineSound. The Soundid field identifies which sound is to be played. The Soundinfo field 
defines how the sound is played. Stop a sound by setting the SyncStop flag in the 
SOUNDINFO record. 

The minimum file format version is SWF 1. 


StartSound 



Field 

Type 

Comment 

Header 

RECORDHEADER 

Tag type = 15. 

Soundid 

UI16 

ID of sound character to play. 

Soundinfo 

SOUNDINFO 

Sound style information. 

Sound styles 



SOUNDINFO 



The SOUNDINFO record modifies how an event sound 
with the DefineSound tag. Sound characteristics that can 

is played. An event sound is defined 
be modified include: 

■ Whether the sound loops (repeats) and how many times it loops. 

■ Where sound playback begins and ends. 

■ A sound envelope for time-based volume control. 

SOUNDINFO 



Field 

Type 

Comment 

Reserved 

UB[2] 

Always 0. 

SyncStop 

UB[1] 

Stop the sound now. 

SyncNoMultiple 

UB[1] 

Don’t start the sound if already 
playing. 

HasEnvelope 

UB[1] 

Has envelope information. 

HasLoops 

UB[1] 

Has loop information. 

HasOutPoint 

UB[1] 

Has out-point information. 

HasInPoint 

UB[1] 

Has in-point information. 

InPoint 

If HasInPoint UI32 

Number of samples to skip at 
beginning of sound. 
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SOUNDINFO 




Field 


Type 

Comment 

OutPoint 


If HasOutPoint UI32 

Position in samples of last 
sample to play. 

LoopCount 


If HasLoops UI16 

Sound loop count. 

EnvPoints 


If HasEnvelope UI8 

Sound Envelope point count. 

EnvelopeRecords 


If HasEnvelope 

SOUNDENVELOPE[EnvPoi 

nts] 

Sound Envelope records. 

SOUNDENVELOPE 


The SOUNDENVELOPE structure is defined as follows: 


SOUNDENVELOPE 



Field 


Type 

Comment 

Pos44 


UI32 

Position of envelope point 
as a number of 44 kHz 
samples. Multiply 
accordingly if using a 
sampling rate less than 44 
kHz. 

LeftLevel 


UI16 

Volume level for left 
channel. Minimum isO, 
maximum is 32768. 

RightLevel 


UI16 

Volume level for right 
channel. Minimum isO, 
maximum is 32768. 

For mono sounds, 
differ, they will be 

set the LeftLevel and RightLevel fields to the same value. If the values 
averaged. 
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Streaming sound 

The SWF file format supports a streaming sound mode where sound data is played and 
downloaded in tight synchronization with the timeline. In this mode, sound packets are 
stored with each frame. 

When streaming sound is present, and the playback CPU is too slow to maintain the desired 
SWF frame rate, Flash Player skips frames of animation in order to maintain sound 
synchronization and avoid dropping sound samples. (Actions from the skipped frames are 
still executed.) 

The main timeline of a SWF file can only have a single streaming sound playing at a time, but 
each sprite can have its own streaming sound (see Sprites and Movie Clips). 


Sou ndStream Head 

If a timeline contains streaming sound data, there must be a SoundStreamHead or 
SoundStreamHead2 tag before the first sound data block (see SoundStreamBlock). The 
SoundStreamHead tag defines the data format of the sound data, the recommended playback 
format, and the average number of samples per SoundStreamBlock. 

The minimum file format version is SWF 1. 


SoundStreamHead 



Field 

Type 

Comment 

Header 

RECORDHEADER 

Tag type = 18. 

Reserved 

UB[4] 

Always zero. 

PlaybackSoundRate 

UB[2] 

Playback sampling rate 

0 = 5.5 kHz 

1 = 11 kHz 

2 = 22 kHz 

3 = 44 kHz 

PlaybackSoundSize 

UB[1] 

Playback sample size. 

Always 1 (16 bit). 

PlaybackSoundType 

UB[1] 

Number of playback channels: 
mono or stereo. 

0 = sndMono 

1 = sndStereo 
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SoundStreamHead 



Field 

Type 

Comment 

StreamSoundCompression 

UB[4] 

Format of streaming sound 
data. 

1 =ADPCM 

SWF 4 and later only: 

2 = MP3 

StreamSoundRate 

UB[2] 

The sampling rate of the 
streaming sound data. 

0 = 5.5 kHz 

1 = 11 kHz 

2 = 22 kHz 

3 = 44 kHz 

StreamSoundSize 

UB[1] 

The sample size of the 
streaming sound data. 

Always 1 (16 bit). 

StreamSoundT ype 

UB[1] 

Number of channels in the 
streaming sound data. 

0 = sndMono 

1 = sndStereo 

StreamSoundSampleCount 

UI16 

Average number of samples in 
each SoundStreamBlock. Not 
affected by mono/stereo 
setting; for stereo sounds this is 
the number of sample pairs. 

LatencySeek 

If StreamSoundCompression 
= 2 

SI16 

Otherwise absent 

See MP3 sound data. The 
value here should match the 
SeekSamples field in the first 
SoundStreamBlock for this 

stream. 

The PlaybackSoundRate, PlaybackSoundSize, and PlaybackSoundType fields are advisory 
only; Flash Player may ignore them. 
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SoundStreannHead2 


The SoundStreamHead2 tag is identical to the SoundStreamHead tag, except it allows 
different values for StreamSoundCompression and StreamSoundSize (SWF 3 file format). 


SoundStreannHead2 



Field 

Type 

Comment 

Header 

RECORDHEADER 

Tag type = 45 

Reserved 

UB[4] 

Always zero. 

PlaybackSoundRate 

UB[2] 

Playback sampling rate. 

0 = 5.5 kHz 

1 = 11 kHz 

2 = 22 kHz 

3 = 44 kHz 

PlaybackSoundSize 

UB[1] 

Playback sample size. 

0 = 8-bit 

1= 16-bit 

PlaybackSoundType 

UB[1] 

Number of playback channels. 

0 = sndMono 

1 = sndStereo 

StreamSoundCompression 

UB[4] 

Format of streaming sound 
data. For explanation of 0 vs. 3, 
see DefineSound. 

0 = uncompressed 

1 = ADPCM 

SWF 4 or later only: 

2 = MP3 

3 = uncompressed little-endian 
SWF 6 or later only: 

6 = Nellymoser 

StreamSoundRate 

UB[2] 

The sampling rate of the 
streaming sound data. 

5.5 kHz is not allowed for MP3. 
0 = 5.5 kHz 

1 = 11 kHz 

2 = 22 kHz 

3 = 44 kHz 
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Comment 


SoundStreamHead2 

Field Type 


Size of each sample. Always 16 
bit for compressed formats. 
May be 8 or 16 bit for 
uncompressed formats. 

0 = 8-bit 
1= 16-bit 


StreamSoundSize UB[1] 


StreamSoundType UB[1] 


StreamSoundSampleCount UI16 


LatencySeek 


Number of channels in the 
streaming sound data. 

0 = sndMono 
1 = sndStereo 

Average number of samples in 
each SoundStreamBlock. Not 
affected by mono/stereo 
setting; for stereo sounds this is 
the number of sample pairs. 


If StreamSoundCompression 
= 2 
SI16 

Otherwise absent 


See MP3 sound data. The value 
here should match the 
SeekSamples field in the first 
SoundStreamBlock for this 
stream. 


The PlaybackSoundRate, PlaybackSoundSize, and PlaybackSoundType fields are advisory 
only; Flash Player may ignore them. 


SoundStreamBlock 

The SoundStreamBlock tag defines sound data that is interleaved with frame data so that 
sounds can be played as the SWF file is streamed over a network connection. The 
SoundStreamBlock tag must be preceded by a SoundStreamHead or SoundStreamHead2 tag. 
There may only be one SoundStreamBlock tag per SWF frame. 

The minimum file format version is SWF 1. 

SoundStreamBlock 

Field Type Comment 

Header RECORDHEADER (long) Tag type = 19. 

StreamSoundData UI8[size of compressed data] Compressed sound data. 


Streaming sound 213 









The contents of StreamSoundData vary depending on the value of the 

StreamSoundCompression field in the SoundStreamHead tag: 

■ If StreamSoundCompression is 0 or 3, StreamSoundData contains raw, uncompressed 
samples. 

■ If StreamSoundCompression is 1, StreamSoundData contains an ADPCM sound data 
record. 

■ If StreamSoundCompression is 2, StreamSoundData contains an MP3 sound data record. 

■ If StreamSoundCompression is 6, StreamSoundData contains a NELLYMOSERDATA 
record. 


MP3STREAMSOUNDDATA 



Field 

Type 

Comment 

SampleCount 

UI16 

Number of samples 
represented by this block. Not 
affected by mono/stereo 
setting; for stereo sounds this 
is the number of sample pairs. 

MpSSoundData 

MP3SOUNDDATA 

MP3 frames with 

SeekSamples values. 


Frame subdivision for streaming sound 

The best streaming sound playback is obtained by providing a SoundStreamBlock tag in every 
SWF frame, and including the same number of sound samples in each SoundStreamBlock. 
The ideal number of samples per SWF frame is easily determined; divide the sampling rate by 
the SWF frame rate. If this results in a non-integer number, write an occasional 
SoundStreamBlock with one more or one fewer samples, so that the average number of 
samples per frame remains as close as possible to the ideal number. 

For uncompressed audio, it is possible to include an arbitrary number of samples in a 
SoundStreamBlock, so an ideal number of samples can be included in each SWF frame. For 
MP3 sound, the situation is different. MP3 data is itself organized into frames, and an MP3 
frame contains a fixed number of samples (576 or 1152, depending on the sampling rate). 
SoundStreamBlocks containing MP3 data must contain whole MP3 frames rather than 
fragments, so a SoundStreamBlock with MP3 data always contains a number of samples that 
is a multiple of 576 or 1152. 
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There are two requirements for keeping MP3 streaming sound in sync with SWF playback: 

■ Distribute MP3 frames appropriately among SWF frames. 

■ Provide appropriate SeekSamples values in SoundStreamBlock tags. 

These techniques are described in the rest of this section. 

For streaming ADPCM sound, the logic for distributing ADPCM packets among SWF 
frames is identical to distributing MP3 frames among SWF frames. Ffowever, for ADPCM 
sound, there is no concept of SeekSamples or latency. For this and other reasons, MP3 is a 
preferable format for SWF 4 or later files. 

To determine the ideal number of MP3 frames for each SWF frame, divide the ideal number 
of samples per SWF frame by the number of samples per MP3 frame. This will usually result 
in a non-integer number. Achieve the ideal average by interleaving SoundStreamBlocks with 
different numbers of MP3 frames. For example, at a SWF frame rate of 12 and a sampling 
rate of 11 kFIz, there are 576 samples per MP3 frame; the ideal number of MP3 frames per 
SWF frame is (11025 / 12) / 576, roughly 1.6; this can be achieved by writing 
SoundStreamBlocks with one or two MP3 frames. While writing SoundStreamBlocks, keep 
track of the difference between the ideal number of total samples and the total number of 
samples written so far. Put as many MP3 frames in each SoundStreamBlock as is possible 
without exceeding the ideal number. Then, in each SoundStreamBlock, use the difference 
between the ideal and actual numbers of samples as of the end of the prior SWF frame as the 
value of SeekSamples. This will enable Flash Player to begin sound playback at exactly the 
right point after a seek occurs. Here is an illustration of this example: 


MP3 


SWF 


0 576 1152 1728 2304 


frame 1 

frame 2 

frame 3 

frame 4 



frame 1, seet^O 


frame 2, seek=343 


frame 3, seek=110 


I 

0 


I 

919 


I 

1838 


I 

2756 


The SoundStreamBlock in SWF Frame 1 contains one MP3 frame and has SeekSamples set 
to zero. Frame 2 contains two MP3 frames and has SeekSamples set to 919 - 576 = 343. 
Frame 3 contains one MP3 frame and has SeekSamples set to 1838 - 1728 = 110. 

In continuous playback. Flash Player will string all of the MP3 frames together and play them 
at their natural sample rate, reading ahead in the SWF bitstream to build up a buffer of sound 
data (this is why it is acceptable to include less than the ideal number of samples in a SWF 
frame). After a seek to a particular frame, such as is prompted by an ActionGotoFrame, Flash 
Player will skip the number of samples indicated by SeekSamples. For example, after a seek to 
Frame 2, it will skip 343 samples of the SoundStreamBlock data from Frame 2, which will 
cause sound playback to begin at sample 919, the ideal value. 
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If the ideal number of MP3 frames per SWF frame is less than one, there will be SWF frames 
whose SoundStreamBloclcs cannot accommodate any MP3 frames without exceeding the 
ideal number of samples. In this case, write a SoundStreamBlock with SampleCount = 0, 
SeekSamples = 0, and no MP3 data. 


Some MP3 encoders have an initial latency, generating a number of silent or meaningless 
samples before the desired sound data begins. This can help the Flash Player MP3 decoder as 
well, providing some ramp-up data before the samples that are needed. In this situation, 
determine how many samples the initial latency occupies, and supply that number for 
SeekSamples in the first SoundStreamBlock. Flash Player will add this number to the 
SeekSamples for any other frame when performing a seek. Latency also affects the decision as 
to how many MP3 frames to put into a SoundStreamBlock. Here is a modification of the 
above example with a latency of 940 samples: 

0 576 1152 1728 2304 


frame 1 

frame 2 

frame 3 

frame 4 



SWF 


frame 1, seeli^940 


frame 2, seek=131 


I 

0 


I 

919 


I 

1838 


The SoundStreamBlock in SWF Frame 1 contains three MP3 frames, the maximum that can 
be accommodated without exceeding the ideal number of samples after adjusting for latency 
(represented by the leftward shift of the MP3 timeline above). The value of SeekSamples in 
Frame 1 is special; it represents the latency. Frame 2 contains one MP3 frame and has 
SeekSamples set to 9 1 9 - (1728 - 940) = 131. 


ADPCM compression 

ADPCM (Adaptive Differential Pulse Code Modulation) is a family of audio compression 
and decompression algorithms. It is a simple but efficient compression scheme that avoids any 
licensing or patent issues that arise with more sophisticated sound compression schemes, and 
helps to keep player implementations small. 

For SWF 4 or later files, MP3 compression is a preferable format. MP3 produces substantially 
better sound for a given bitrate. 

ADPCM uses a modified Differential Pulse Code Modulation (DPCM) sampling technique 
where the encoding of a each sample is derived by calculating a “difference” (DPCM) value, 
and applying to this a complex formula which includes the previous quantization value. The 
result is a compressed code, which can recreate almost the same subjective audio quality. 
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A common implementation takes 16-bit linear PCM samples and converts them to 4-bit 
codes, yielding a compression rate of 4:1. Public domain C code written by Jack Jansen is 
available at ftp.cwi.nl/pub/audio/adpcm.zip. 

The SWF file format extends Jansen’s implementation to support 2-, 3-, 4- and 5-bit 
ADPCM codes. When choosing a code size, there is the usual trade-off between file size and 
audio quality. The code tables used in SWF file format are as follows (note that each structure 
here provides only the unique lower half of the range, the upper half being an exact duplicate): 

int indexTable2[2] = (-1, 2); 

int indexTable3[4] = (-1, -1, 2, 4); 

int indexTable4[8] = {-1, -1, -1, -1, 2, 4, 6, 8); 

int indexTable5[16] = {-1, -1, -1, -1, -1, -1, -1, -1, 1, 2, 4. 6. 8, 10, 
13. 16); 

ADPCM sound data 

The ADPCMSOUNDATA record defines the size of the ADPCM codes used, and an array 
of ADPCMPACKETs which contain the ADPCM data. 


ADPCMSOUNDDATA 


Field 

Type 

Comment 

AdpcmCodeSize 

UB[2] 

Bits per ADPCM code less 2. 


0 = 2 bits/sample 

The actual size of each code Is 


1 = 3 bits/sample 

2 = 4 bits/sample 

3 = 5 bits/sample 

AdpcmCodeSize + 2. 

AdpcmPackets 

If SoundType = mono 
ADPCMMONOPACKET 
[one or more] 

If SoundType = stereo 
ADPCMSTEREOPACKET 
[one or more] 

Array of ADPCMPACKETS. 
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ADPCMPACKETs vary in structure depending on whether the sound is mono or stereo. 


ADPCMMONOPACKET 



Field 

Type 

Comment 

InitialSample 

UI16 

First sample. Identical to 
first sample In 
uncompressed sound. 

Initialindex 

UB[6] 

Initial Index Into the 

ADPCM StepSizeTable.* 

AdpcmCodeData 

UB[4096 * 

(AdpcmCodeSize+2)] 

4096 ADPCM codes. 

Each sample Is 
(AdpcmCodeSIze + 2) bits. 


ADPCMSTEREOPACKET 


Field 

Type 

Comment 

InitialSampleLeft 

UI16 

First sample for left 
channel. Identical to first 
sample in uncompressed 
sound. 

InitialIndexLeft 

UB[6] 

Initial index into the 

ADPCM StepSizeTable* 
for left channel. 

InitialSampleRight 

UI16 

First sample for right 
channel. Identical to first 
sample in uncompressed 
sound. 

InitialIndexRight 

UB[6] 

Initial index into the 

ADPCM StepSizeTable* 
for right channel 

AdpcmCodeData 

UB[8192 * (AdpcmCodeSize+2)] 

4096 ADPCM codes per 
channel, total 8192. Each 
sample Is 

(AdpcmCodeSIze + 2) bits. 
Channel data Is interleaved 
left, then right. 

* For an explanation of StepSizeTable, see the Jansen source code. 
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MP3 compression 


MP3 is a sophisticated and complex audio compression algorithm supported in SWF 4 and 
later. It produces superior audio quality at better compression ratios than ADPCM. Generally 
speaking, MP3 refers to MPEGl Layer 3; however, the SWF file format supports later 
versions of MPEG (V2 and 2.5) that were designed to support lower bitrates. Flash Player 
supports both GBR (constant bitrate) and VBR (variable bitrate) MP3 encoding. 

For more information on MP3, see www.mp3-tech.org/ and www.iis.fhg.de/amm/techinf/ 
layer3/index.html. Writing an MP3 encoder is quite difficult, but public-domain MP3 
encoding libraries may be available. 


z 


o 


H 


m 

1 


Be aware that software and hardware MP3 encoders and decoders might have their 
own licensing requirements. 


MP3 sound data 

MP3 sound data is described in the following table: 

MP3SOUNDDATA 

Field Type Comment 

SeekSamples Si16 Number of samples to skip. 

Mp3Frames MP3FRAME[zero or more] Array of MP3 frames. 


The SeekSamples field is explained in the section describing Frame subdivision for streaming 
sound. 


z 


o 


H 
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For event sounds, SeekSamples is limited to specifying initial latency. 
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MP3 frame 


The MP3FRAME record corresponds exactly to an MPEG audio frame that you would find 
in an MP3 music file. The first 32 bits of the frame contain header information, followed by 
an array of bytes, which are the encoded audio samples. 


MP3FRAME 



Field 

Type 

Comment 

Syncword 

UB[11] 

Frame sync. 

All bits must be set. 

MpegVerslon 

UB[2] 

MPEG2.5 Is an extension to 


MPEG2 that handles very low 
bitrates, allowing the use of 
lower sampling frequencies. 

0 = MPEG Version 2.5 

1 = reserved 

2 = MPEG Version 2 

3 = MPEG Version 1 

Layer UB[2] Layer Is always equal to 1 for 

MP3 headers In SWF files. The 
“3” In MP3 refers to the Layer, 
not the MpegVerslon. 

0 = reserved 

1 = Layer III 

2 = Layer II 

3 = Layer I 

ProtectlonBIt LIB[1] If ProtectlonBIt == 0 a16-blt 

CRC follows the header 
0 = Protected by CRC 
1 = Not protected 
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MP3FRAME 

Field Type Comment 

Bitrate UB[4] Bitrates are in thousands of bits 

per second. For example, 128 
means 128000 bps. 


Value MPEGl MPEG2.X 


0 

free 

free 

1 

32 

8 

2 

40 

16 

3 

48 

24 

4 

56 

32 

5 

64 

40 

6 

80 

48 

7 

96 

56 

8 

112 

64 

9 

128 

80 

10 

160 

96 

11 

192 

112 

12 

224 

128 

13 

256 

144 

14 

320 

160 

15 

bad 

bad 


SamplingRate UB[2] Sampling rate in Hz. 

Value MPEGl MPEG2 
MPEG2.5 


0 44100 2205011025 

1 480002400012000 

2 3200016000 8000 


PaddingBit UB[1] Padding is used to fit the bitrate 

exactly. 

0 = frame is not padded 
1 = frame is padded with one 
extra slot 

Reserved UB[1] 
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MP3FRAME 



Field 

Type 

Comment 

ChannelMode 

UB[2] 

Dual-channel files are made of 
two independent mono 
channels. Each one uses 
exactly half the bitrate of the 
file. 

0 = Stereo 

1 = Joint stereo (Stereo) 

2 = Dual channel 

2 = Single channel (Mono) 

ModeExtension 

UB[2] 


Copyright 

UB[1] 

0 = Audio is not copyrighted 

1 = Audio is copyrighted 

Original 

UB[1] 

0 = Copy of original media 

1 = Original media 

Emphasis 

UB[2] 

0 = none 

1 = 50/15 ms 

2 = reserved 

3 = CCITJ.17 

SampleData 

UB[size of sample data*] 

The encoded audio samples. 


* The size of the sample data is calculated like this (using integer arithmetic): 

Size = (((MpegVersion == MPEGl ? 144 : 72) * Bitrate) / SamplingRate) + 
PaddingBit - 4 

For example: The size of the sample data for an MPEGl frame with a Bitrate of 128000, a 
SamplingRate of 44100, and PaddingBit of 1 is: 

Size = (144 * 128000) / 44100 + 1 - 4 = 414 bytes 

Nellymoser compression 

Starting with SWF 6, a compressed sound format called Nellymoser Asao is available. This is a 
single-channel (mono) format optimized for low-bitrate transmission of speech. The format 
was developed by Nellymoser Inc. at www.nellymoser.com. 

A summary of the Nellymoser Asao encoding process is provided here. For full details of the 
Asao format, contact Nellymoser. 
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Asao uses frequency-domain characteristics of sound for compression. Sound data is grouped 
into frames of 256 samples. Each frame is converted into the frequency domain and the most 
significant (highest-amplitude) frequencies are identified. A number of frequency bands are 
selected for encoding; the rest are discarded. The bitstream for each frame then encodes which 
frequency bands are in use and what their amplitudes are. 
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CHAPTER 14 


Buttons 


14 


Button characters in the Macromedia Flash SWF 8 file format serve as interactive elements. 
They can react programmatically to events that occur. The most common event to handle is a 
simple click from the mouse, but more complex events can be trapped as well. 


Button states 


A button object can be displayed in one of three states-, up, over, or down. 

The up state is the default appearance of the button. The up state is displayed when the Flash 
file starts playing, and whenever the mouse is outside the button. The over state is displayed 
when the mouse is moved inside the button. This allows rollover or hover buttons in a Flash 
file. The down state is the clicked appearance of the button. It is displayed when the mouse is 
clicked inside the button. 

A fourth state—the hit state —defines the active area of the button. This is an invisible state 
and is never displayed. It defines the area of the button that reacts to mouse clicks. This hit 
area is not necessarily rectangular and need not reflect the visible shape of the button. 

Each state is made up of a collection of instances of characters from the dictionary. Each such 
instance is defined using a Button record, which, within a button definition, acts like a 
PlaceObject tag. For the up, over, and down states, these characters are placed on the display 
list when the button enters that state. For the hit-area state, these characters define the active 
area of the button. 

The following is an example of a typical button and its four states. The button is initially blue. 
When the mouse is moved over the button, it changes to a purple color. When the mouse is 
pressed inside the button, the shading changes to simulate a depressed button. The fourth 
state—the hit area—is a simple rectangle. Anything outside this shape is outside the button, 
and anything inside this shape is inside the button. 
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The SWF file format has no native support for radio buttons or check boxes. There is no 
“checked” (selected) state, and buttons cannot “stick” down after the mouse is released. In 
addition, there is no way to group buttons into mutually exclusive choices. However, both of 
these behaviors can be simulated by using button actions. 

Button tracking 

Button tracking refers to how a button behaves as it tracks the movement of the mouse. A 
button object can track the mouse in one of two modes: 

1 . As a push button. 

2. As a menu button. 

If a push button is clicked, all mouse movement events are directed to the push button until 
the mouse button is released. This is called capturing the mouse. For example, if you click a 
push button and drag outside the button (without releasing), the button changes to the over 
state, and the pointer remains a pointing hand. 

Menu buttons do not capture the mouse. If you click a menu button and drag outside, the 
button changes to the up state, and the pointer reverts to an arrow. 

Events, state transitions, and actions 

A button object can perform an action whenever a state transition occurs (that is, when the 
button changes from one state to another). A state transition occurs in response to some event, 
such as a mouse click, or mouse entering the button. In the SWF file format, events are 
described as state transitions. The following table shows possible state transitions and 
corresponding Flash events: 


State Transition 

Flash Event 

Description 

Visual Effect 

IdleToOverUp 

Roll Over 

Mouse enters the hit 

area while the mouse 
button is up. 

Button changes from up 
to over state. 

OverUpToldle 

Roll Out 

Mouse leaves the hit 

area while the mouse 
button is up. 

Button changes from 
over to up state. 
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State Transition 

Flash Event 

Description 

Visual Effect 

OverUpT oOverDown 

Press 

Mouse button is pressed 
while the mouse is inside 

the hit area. 

Button changes from 
over to down state. 

OverDownT oOverUp 

Release 

Mouse button is 

released while the 
mouse is inside the hit 

area. 

Button changes from 
down to over state. 

The following transitions only apply when tracking Push buttons: 

State Transition 

Flash Event 

Description 

Visual Effect 

OutDownT oOverDown 

Drag Over 

Mouse is dragged inside 
the hit area while the 

mouse button is down. 

Button changes from 
over to down state. 

OverDownT oOutDown 

Drag Out 

Mouse is dragged 
outside the hit area while 

the mouse button is 

down. 

Button changes from 
down to over state. 

OutDownToldle 

Release 

Outside 

Mouse button is 

released outside the hit 

area while the mouse is 
captured. 

Button changes from 
over to up state. 

The following transitions apply only when tracking Menu buttons: 

State Transition 

Flash Event 

Description 

Visual Effect 

IdleToOverDown 

Drag Over 

Mouse is dragged inside 
the hit area while the 

mouse button is down. 

Button changes from up 
to down state. 

OverDownToldle 

Drag Out 

Mouse is dragged 
outside the hit area while 

the mouse button is 

down. 

Button changes from 
down to up state. 

Often button actions are 

performed only 

on OverDownToOverUp (when the mouse button 


is released), but DefineButton2 allows actions to be triggered by any state transition. 
A button object can perform any action supported by the SWF 3 actions. 
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Button tags 


Button record 

A button record defines a character to be displayed in one or more button states. The 
ButtonState flags indicate which state (or states) the character belongs to. 

A one-to-one relationship does not exist between button records and button states. A single 
button record can apply to more than one button state (by setting multiple ButtonState flags), 
and multiple button records can be present for any button state. 

Each button record also includes a transformation matrix and depth (stacking-order) 
information. These apply just as in a PlaceObject tag, except that both pieces of information 
are relative to the button character itself. 

SWF 8 and later supports the new ButtonHasBlendMode and ButtonHasFilterList fields to 
support blend modes and bitmap filters on buttons. Flash Player 7 and earlier ignores these 
two fields. 


BUTTONRECORD 



Field 

Type 

Comment 

ButtonReserved 

UB[2] 

Reserved bits; always 0 

ButtonHasBlendMode 

UB[1] 

0 = No blend mode 

1 = Has blend mode (SWF 8 
and later only) 

ButtonHasFilterList 

UB[1] 

0 = No filter list 

1 = Has filter list (SWF 8 and 
later only) 

ButtonStateHitT est 

UB[1] 

Present in hit test state 

ButtonStateDown 

UB[1] 

Present in down state 

ButtonStateOver 

UB[1] 

Present in over state 

ButtonStateUp 

UB[1] 

Present in up state 

CharacterlD 

UI16 

ID of character to place 

PlaceDepth 

UI16 

Depth at which to place 
character 

PlaceMatrix 

MATRIX 

Transformation matrix for 
character placement 

ColorTransform 

If within DefineButton2, 
CXFORMWITHALPHA 

Character color transform 
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BUTTONRECORD 



Field 

Type 

Comment 

FilterList 

If within DefineButton2 and 
ButtonHasFilterList = 1, 
FILTERLIST 

List of filters on this button 

BlendMode 

If within DefineButton2 and 

0 or1 = normal 


ButtonHasBIendMode = 1, 

2 = layer 


UI8 

3 = multiply 

4 = screen 

5 = lighten 

6 = darken 

7 = add 

8 = subtract 

9 = difference 

10 = invert 

11 = alpha 

12 = erase 

13 = overlay 

14 = hardlight 

Values 15 to 255 are reserved. 


DefineButton 

The DefineButton tag defines a button character for later use by control tags such as 
PlaceObject. 

DefineButton includes an array of Button records that represent the four button shapes: an up 
character, a mouse-over character, a down character, and a hit-area character. It is not 
necessary to define all four states, but at least one button record must be present. For example, 
if the same button record defines both the up and over states, only three button records are 
required to describe the button. 

More than one button record per state is allowed. If two button records refer to the same state, 
both are displayed for that state. 

DefineButton also includes an array of ACTIONRECORDs, which are performed when the 
button is clicked and released (see SWF 3 actions). 
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The minimum file format version is SWF 1. 


DefineButton 

Field 

Type 

Comment 

Header 

RECORDHEADER 

Tag type = 7 

Buttonid 

UI16 

ID for this character 

Characters 

BUTTONRECORD[one or 
more] 

Characters that make up the 
button 

CharacterEndFlag 

UI8 

Must be 0 

Actions 

ACTiONRECORD[zero or 
more] 

Actions to perform 

ActionEndFlag 

UI8 

Must be 0 

DefineButton2 

DefineButton2 extends the capabilities of DefineButton by allowing any state transition to 
trigger actions. 

The minimum file format version is SWF 3: 

DefineButton2 

Field 

Type 

Comment 

Header 

RECORDHEADER 

Tag type = 34 

Buttonid 

UI16 

ID for this character 

ReservedFlags 

UB[7] 

Always 0 

TrackAsMenu 

UB[1] 

0 = track as normal button 

1 = track as menu button 

ActionOffset 

UI16 

Offset in bytes from start of this 
field to the first 

BUTTONCONDACTION, or 0 
if no actions occur 

Characters 

BUTTONRECORD 
[one or more] 

Characters that make up the 
button 

CharacterEndFlag 

UI8 

Must be 0 

Actions 

BUTTONCONDACTION 
[zero or more] 

Actions to execute at particular 
button events 
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The actions associated with DefmeButton2 are specified as follows: 


BUTTONCONDACTION 



Field 

Type 

Comment 

CondActionSize 

UI16 

Offset in bytes from start of this 
field to next 

BUTTONCONDACTION, or 0 
if last action 

CondIdleT oOverDown 

UB[1] 

Idle to OverDown 

CondOutDownToldle 

UB[1] 

OutDown to Idle 

CondOutDownT oOverDown 

UB[1] 

OutDown to OverDown 

CondOverDownT oOutDown 

UB[1] 

OverDown to OutDown 

CondOverDownT oOverUp 

UB[1] 

OverDown to OverUp 

CondOverUpT oOverDown 

UB[1] 

OverUp to OverDown 

CondOverUpToldle 

UB[1] 

OverUp to Idle 

CondIdleToOverUp 

UB[1] 

Idle to OverUp 

CondKeyPress 

UB[7] 

SWF 4 or later: key code 
Otherwise: always 0 

Valid key codes: 

1 = left arrow 

2 = right arrow 

3 = home 

4 = end 

5 = insert 

6 = delete 

8 = backspace 

13 = enter 

14 = up arrow 

15 = down arrow 

16 = page up 

17 = page down 

18 = tab 

19 = escape 

32 to 126: follows ASCII 

CondOverDownToldle 

UB[1] 

OverDown to Idle 

Actions 

ACTIONRECORD 

Actions to perform. See 


[zero or more] 

DoAction. 

ActionEndFlag 

UI8 

Must be 0 
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For each event handler (each BUTTONCONDACTION), one or more of the Cond bit 
fields should be filled in. This specifies when the event handler should be executed. 

CondKeyPress specifies a particular key to trap. A CondKeyPress event handler is executed 
even if the button that it applies to does not have input focus. For the 32 to 126 ASCII key 
codes, the key event that is trapped is composite —it takes into account the effect of the Shift 
key. To trap raw key events, corresponding directly to keys on the keyboard (including the 
modifier keys themselves), use clip event handlers instead. 


DefineButtonCxform 

DefineButtonCxform defines the color transform for each shape and text character in a 
button. This is not used for DefineButton2, which includes its own CXFORM. 

The minimum file format version is SWF 2. 


DefineButtonCxform 



Field 

Type 

Comment 

Header 

RECORDHEADER 

Tag type = 23 

Buttonid 

UI16 

Button ID for this information 

ButtonColorT ransform 

CXFORM 

Character color transform 

DefineButtonSound 


The DefineButtonSound tag defines which sounds (if any) 

are played on state transitions. 

The minimum file format 

version is SWF 2. 


DefineButtonSound 



Field 

Type 

Comment 

Header 

RECORDHEADER 

Tag type = 17 

Buttonid 

UI16 

The ID of the button these 
sounds apply to. 

ButtonSoundCharO 

UI16 

Sound ID for OverUpToldle 

ButtonSoundInfoO 

SOUNDINFO (if 
ButtonSoundCharO is 
nonzero) 

Sound style for OverUpToldle 

ButtonSoundCharl 

UI16 

Sound ID for IdleToOverUp 
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DefineButtonSound 

Field 

Type 

Comment 

ButtonSoundInfol 

SOUNDINFO (if 
ButtonSoundCharl is 
nonzero) 

Sound style for IdleToOverUp 

ButtonSoundChar2 

UI16 

Sound ID for 

OverUpT oOverDown 

ButtonSoundlnfo2 

SOUNDINFO (if 
ButtonSoundChar2 is 
nonzero) 

Sound style for 

OverUpT oOverDown 

ButtonSoundCharS 

UI16 

Sound ID for 

OverDownT oOverU p 

ButtonSoundInfoS 

SOUNDINFO (if 
ButtonSoundCharS is 
nonzero) 

Sound style for 

OverDownT oOverU p 
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CHAPTER 15 


15 


Sprites and Movie Clips 


A sprite corresponds to a movie clip in the Macromedia Flash authoring application. It is a 
Macromedia Flash SWF file contained within a SWF file, and supports many of the features 
of a regular Flash file, such as the following: 

■ Most of the control tags that can be used in the main file. 

■ A timeline that can stop, start, and play independently of the main file. 

■ A streaming sound track that is automatically mixed with the main sound track. 

A sprite object is defined with a DeflneSprite tag. It consists of a character ID, a frame count, 
and a series of control tags. Definition tags (such as DefmeShape) are not allowed in the 
DeflneSprite tag. All of the characters that control tags refer to in the sprite must be defined 
outside the sprite, and before the DeflneSprite tag. 

Once defined, a sprite is displayed with a PlaceObject2 tag in the main file. The transform 
(specified in PlaceObject) is concatenated with the transforms of objects placed inside the 
sprite. These objects behave like children of the sprite, so when the sprite is moved, the 
objects inside the sprite move too. Similarly, when the sprite is scaled or rotated, the child 
objects are also scaled or rotated. A sprite object stops playing automatically when it is 
removed from the display list. 
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Sprite names 

When a sprite is placed on the display list, it can be given a name with the PlaceObject2 tag. 
This name is used to identify the sprite so that the main file (or other sprites) can perform 
actions inside the sprite. This is achieved with the SetTarget action (see ActionSetTarget). 

For example, say a sprite object is placed in the main file with the name "spinner". The main 
file can send this sprite to the first frame in its timeline with the following action sequence: 

1 . SetTarget "spinner" 

2 . GotoFrame zero 

3 . SetTarget "" (empty string) 

4 . End of actions. 

(Action code = 0) 


All actions following SetTarget “spi nner” apply to the spinner object until SetTarget 
which sets the action context back to the main file. 

The SWF file format supports placing sprites within sprites, which can lead to complex 
hierarchies of objects. To handle this complexity, the SWF file format uses a naming 
convention similar to that used by file systems to identify sprites. 

For example, the following outline shows four sprites defined within the main file: 

MainMovie.swf 

SpriteA (name: Jack) 

SpriteAl (name: Bert) 

SpriteAB (name: Ernie) 

SpriteB (name: Jill) 

The following SetTarget paths identify the preceding sprites: 

■ /Jack targets Spri teA from the main file. 

■ . . / targets the main file from Spri teA. 

■ /Jack/Bert targets SpriteAl from any other sprite or the main file. 

■ Bert targets SpriteAl from SpriteA. 

■ . . /Erni e targets Spri teA2 from Spri teAl. 

■ ../../Jill targets Spri teB from Spri teAl. 


z 

O 

H 

m 
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DefineSprite 

The DefineSprite tag defines a sprite character. It consists of a character ID and a frame count, 
followed by a series of control tags. The sprite is terminated with an End tag. 

The length specified in the Header reflects the length of the entire DefineSprite tag, including 
the ControlTags field. 

Definition tags (such as DefineShape) are not allowed in the DefineSprite tag. All of the 
characters that control tags refer to in the sprite must be defined in the main body of the file 
before the sprite is defined. 

The minimum file format version is SWF 3. 

DefineSprite 


Field 

Type 

Comment 

Header 

RECORDHEADER 

Tag type = 39 

Sprite ID 

UI16 

Character ID of sprite 

FrameCount 

UI16 

Number of frames In sprite 

ControlTags 

TAG[one or more] 

A series of tags 

The following tags are valid within a DefineSprite tag: 


• ShowFrame 

• StartSound 


• PlaceObject 

• FrameLabel 


• PlaceObject2 

• SoundStreamHead 


• RemoveObject 

• SoundStreamHead2 


• RemoveObject2 

• SoundStreamBlock 


• All Actions (see Actions) 

• End 
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The Macromedia Flash Player 6 and later supports video playback. Video can be provided to 
Flash Player in the following ways: 

■ Embed video within a Macromedia Flash SWF file by using the SWF video tags. 

■ Deliver a video stream over RTMP through the Macromedia Flash Communication 
Server, which, as one option, can obtain the video data from an FLV file format file. 

■ Load an FLV file directly into Flash Player by using the NetStream.play ActionScript 
method. This method is only available in Flash Player 7 and later. The SWF and FLV file 
formats share a common video encoding format. 

Please see the FLV File Format chapter for complete information about the FLV file format. 

Sorenson H.263 Bitstream Format 

As of SWF 6, a single video format, called Sorenson ld.263, is available. This format is based 
on FI.263, an open video encoding standard that is maintained by the ITU. Copies of the 
H.263 standard can be obtained at www.itu.int/. 

All references to the H.263 standard in this document refer to the draft version of H.263, 
dated May 1996, sometimes referred to as H.263vl. This is distinct from the revised version 
of H.263, dated February 1998, sometimes referred to as H.263v2 or H.263+, and currently 
the in-force version of H.263 according to the ITU. 

The Sorenson H.263 video format differs slightly from H.263. For the most part, it is a subset 
of H.263, with some advanced features removed and a few additions. These changes are 
described in this section. 

The Sorenson H.263 video format was developed by Sorenson Media (www.sorenson.com). 
Existing products that can produce Flash video are the Macromedia Flash MX authoring 
application, and Sorenson Squeeze for Macromedia Flash MX, a professional video 
compression application. You can license the Sorenson Spark codec to perform Flash video 
encoding; contact Sorenson Media for details. 
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Summary of differences from H.263 

The following H.263 features are removed from the Sorenson H.263 video format: 

■ GOB (group of blocks) layer 

■ Split-screen indicator 

■ Document camera indicator 

■ Picture freeze release 

■ Syntax-based arithmetic coding 

■ PB frames 

■ Continuous-presence multipoint 

■ Overlapped block-motion compensation 

The following non-H.263 features are added to the Sorenson H.263 video format: 

■ Disposable frames (difference frames with no future dependencies) 

■ Arbitrary picture width and height up to 65535 pixels 

■ Unrestricted motion vector support is always on 

■ A deblocking flag is available to suggest the use of a deblocking filter 

To support these differences, the Sorenson H.263 video format uses different headers than 
H.263 at both the picture layer and the Macroblock layer. The GOB layer is absent. 

Two versions of the Sorenson H.263 video format are defined. In version 0, the block layer is 
identical to H.263. In version 1, escape codes in transform coefficients are encoded differently 
than in H.263. Version 0 and version 1 have no other differences 

Video packet 

The video packet is the top-level structural element in a Sorenson H.263 video packet. It 
corresponds to the picture layer in H.263 section 5.1. This structure is included within the 
VideoFrame tag in the SWF file format, and also within the VIDEODATA structure in the 
FD/ file format. 


H263VIDEOPACKET 



Field 

Type 

Comment 

PictureStartCode 

UB[17] 

Similar to FI.263 5.1.1 

0000 0000 0000 0000 1 

Version 

UB[5] 

Video format version 

Flash Player 6 supports 0 and 1 

TemporalReference 

UB[8] 

See H.263 5.1.2 
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H263VIDEOPACKET 



Field 

Type 

Comment 

PictureSize 

UB[3] 

000: custom, 1 byte 

001: custom, 2 bytes 

010: GIF (352x288) 

Oil: QCIF (176x144) 

100: SQCIF (128x96) 

101: 320x240 

110:160x120 

111: reserved 

CustomWidth 

If PictureSize = 000 UB[8] 

If PictureSize = 001 UB[16] 
Otherwise absent 

Note: LIB[16] is not the same 
as UI16; there is no byte 
swapping. 

Width in pixels 

CustomHeight 

If PictureSize = 000 UB[8] 

If PictureSize = 001 UB[16] 
Otherwise absent 

Note: UB[16] is not the same 
as UI16; there is no byte 
swapping. 

Height in pixels 

PictureType 

UB[2] 

00: intra frame 

01: inter frame 

10: disposable inter frame 

11: reserved 

DeblockingFlag 

UB[1] 

Requests use of deblocking 
filter (advisory only. Flash 

Player may ignore) 

Quantizer 

UB[5] 

See H.263 5.1.4 

ExtralnformationFlag 

UB[1] 

See H.263 5.1.9 

Extrainformation 

If ExtralnformationFlag = 1 
UB[8] 

Otherwise absent 

See H.263 5.1.10 



The ExtralnformationFlag- 
Extralnformation sequence 
repeats until an 
ExtralnformationFlag of 0 is 
encountered 
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H263VIDEOPACKET 



Field 

Type 

Comment 

Macroblock 

MACROBLOCK 

See following 

Picturestuffing 

varies 

See H.263 5.1.13 

Macro block 



The macro block is the next layer down in the video structure. It corresponds to the macro 
block layer in H.263 section 5.3. 

MACROBLOCK 



Field 

Type 

Comment 

CodedMacroblockFlag 

UB[1] 

See H.263 5.3.1 

If 1, macro block ends here 

MacroblockType 

varies 

See H.263 5.3.2 

Can cause various fields (see 
following) to be absent 

BlockPattern 

varies 

See H.263 5.3.5 

Quantizer! nformation 

UB[2] 

See H.263 5.3.6 

00: -1 

01: -2 

10:+1 

11:+2 

MotionVectorData 

varies[2] 

See H.263 5.3.7 

A horizontal code followed by a 
vertical code 

ExtraMotionVectorData 

varies[6] 

See H.263 5.3.8 

Three more MotionVectorData 
code pairs are Included when 
MacroblockType Is INTER4V 

BlockData 

BLOCKDATA[6] 

See H.263 5.4 

Four luminance blocks followed 
by two chrominance blocks 
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Block data 


Block data is the lowest layer in the video structure. In version 0 of the Sorenson H.263 video 
format, this layer follows H.263 section 5.4 exactly. 

In version 1 of the Sorenson H.263 video format, escape codes in transform coefficients (see 
H.263 section 5.4.2) are encoded differently. When the ESCAPE code 0000 011 appears, the 
next bit is a format bit that indicates the subsequent bit layout for LAST, RUN, and LEVEL. 
In both cases, one bit is used for LAST and six bits are used for RUN. If the format bit is 0, 
seven bits are used for LEVEL; if the format bit is 1, eleven bits are used for LEVEL. The 
7-bit and 11-bit LEVEL tables, which replace table 14 in H.263, as the following table shows: 


7-bit LEVELS 



11-bit LEVELS 


Index 

Level 

Code 


Index 

Level 

Code 

- 

-64 

FORBIDDEN 


- 

-1024 

FORBIDDEN 

0 

-63 

1000 001 


0 

-1023 

1000 0000 

001 

61 

-2 

1111110 


1021 

-2 

11111111110 

62 

-1 

1111 111 


1022 

-1 

11111111 111 

- 

0 

FORBIDDEN 


- 

0 

FORBIDDEN 

63 

1 

0000 001 


1023 

1 

0000 0000 

001 

64 

2 

0000 010 


1024 

2 

0000 0000 

010 

125 

63 

0111 111 


2045 

1023 

01111111 111 


Screen video bitstream format 

As of SWF 7, an additional video format, called screen video, is available. Screen video is a 
simple lossless sequential-bitmap format with blocked interframing. It is designed for sending 
captures of computer screens in action. 

Pixel data in the screen video format is compressed by using the ZLIB open standard. 
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Block format 


Each frame in a screen video sequence is formatted as a series of blocks. These blocks form a 
grid over the image. In a keyframe, every block is sent. In an interframe, one or more blocks 
contain no data, which indicates that the bitmap region represented by that block was not 
changed since the last keyframe. 

Blocks have width and height that range from 16 to 256 in multiples of 16. Block height is 
not required to match block width. The block size must not change except at a keyframe. 

Blocks are ordered from the bottom left of the image to the top right, in rows. A fixed layout 
of blocks exists for any given combination of block size and image size. To determine the 
number of blocks in a row of the grid, divide the image width by the block width. If the result 
is not an integer, the end of each row has one partial block, which contains only the number 
of pixels necessary to fill the remaining width of the image. The same logic applies to the 
image height, block height, number of rows in the grid, and partial blocks in the final row. It 
is important to understand the partial-block algorithm to create correct blocks, since the 
pixels within a partial block are extracted with implicit knowledge of the width and height of 
the block. 

The following is an example of blocking. The image in this example is 120 x 80 pixels, and 
the block size is 32 x 32. 


#9 

32x 16 

#10 

32x 16 

#11 

32x 16 

#12 
24x 16 

#5 

32x32 

#6 

32x32 

#7 

32x32 

#8 

24x32 

#1 

32x32 

#2 

32x32 

#3 

32x32 

#4 

24x32 


Video packet 

The video packet is the top-level structural element in a screen video packet. This structure is 
included within the VideoFrame tag in the SWF file format, and also within the 
VIDEODATA structure in the FFV file format. 
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The data consists of information about the image sub-block dimensions and grid size, 
followed by the data for each block. 


SCREENVIDEOPACKET 
Field Type 

BlockWidth UB[4] 


ImageWidth UB[12] 

BlockHeight UB[4] 


ImageHeight UB[12] 

ImageBlocks IMAGEBLOCK[n] 


Comment 

Pixel width of each block in 
the grid. This value is stored 
as 

(actualWidth /16) -1, so 
possible block sizes are a 
multiple of 16 and not more 
than 256. 

Pixel width of the full image. 

Pixel height of each block in 
the grid. This value is stored 
as (actualHeight /16) -1, so 
possible block sizes are a 
multiple of 16 and not more 
than 256. 

Pixel height of the full image. 

Blocks of image data. See 
preceding for details of how 
to calculate n. Blocks are 
ordered from bottom left to 
top right, in rows. 
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Image block 


The image block represents one block in a frame. 


IMAGEBLOCK 



Field 

Type 

Comment 

DataSize 

UB[16] 

Note: UB[16] is not the same 
as UI16; no byte swapping 

occurs. 

Size of the compressed block 
data that follows. If this is an 
interframe, and this block is not 
changed since the last 
keyframe, DataSize is 0 and 
the Data field is absent. 

Data 

If DataSize > 0, 

UI8[DataSize] 

Pixel data compressed using 
ZLIB. Pixels are ordered from 
bottom left to top right in rows. 
Each pixel is three bytes: B, 

G, R. 


Screen Video V2 bitstream format 

SWF 6 also supports a new screen video format, Screen Video Version 2, which is an 
extension of the Screen video bitstream format and is supported in Flash Player 8 and later. 
Screen Video Version 2 uses several techniques to reduce the amount of data for each screen 
block. 

In the initial Screen Video version, each block of screen data is a complete buffer of 
compressed data that can be decompressed to a full 24-bit color image for that block. In the 
Screen Video V2 format, the screen data blocks can be incomplete updates of the image area, 
similar to the concept of keyframes and interframes. 

In the Screen Video V2 format, block data comes in two types: 

Keyblock contains complete information for the block. The contents can be decompressed to 
obtain the complete block image. 

Interblock requires additional data, from a previous image or another block, to construct the 
full block image. 
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Video Packet V2 


Video Packet V2 is the top-level structural element in a screen video packet for Screen Video 
Version 2. This structure is included within the VideoFrame tag in SWF file format, and also 
within the VIDEO DATA structure in FLV file format. 

The data consists of information about the image sub-block dimensions and grid size, 
followed by the data for each block. 

SCREENV2VIDEOPACKET 


Field 

Type 

Comment 

BlockWidth 

UB[4] 

Pixel width of each block in 
the grid. This value is stored 

as 

(actualWidth /16) -1, so 
possible block sizes are a 
multiple of 16 and not more 
than 256. 

ImageWidth 

UB[12] 

Pixel width of the full image. 

BlockHeight 

UB[4] 

Pixel height of each block in 
the grid. This value is stored 
as (actualHeight /16) -1, so 
possible block sizes are a 
multiple of 16 and not more 
than 256. 

ImageHeight 

UB[12] 

Pixel height of the full image. 

Reserved 

UB[6] 

Must be 0 

HasIFramelmage 

UB[1] 

If 1, has IFramelmage 

HasPaletteInfo 

UB[1] 

If 1, has Paletteinfo 

Paletteinfo 

If HasPaletteInfo, 
IMAGEBLOCK 

One block of data to describe 
the palette. 
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SCREENV2VIDEOPACKET 



Field 

Type 

Comment 

ImageBlocks 

IMAGEBLOCKV2[n] 

Blocks of image data. See 
Block format for details of 

howto calculate n. Blocks 

are ordered from bottom left 
to top right in rows and can 
be a combination of 
keyblocks and interblocks. 

IFramelmage 

If HasIFramelmage, 
IMAGEBLOCKV2[n] 

Blocks of image data 
representing interblocks that 
must be combined with the 
previous keyblocks to 
produce the image. See 

Block format for details of 

howto calculate n. Blocks 

are ordered from bottom left 
to top right in rows. 

Image Block V2 



The Image Block V2 structure represents one block in a frame. 


IMAGEBLOCKV2 



Field 

Type 

Comment 

DataSize 

UB[16] 

Note: UB[16] is not the 
same as UI16; there is no 
byte swapping. 

Size of the compressed 
block data that follows, 
including the ImageFormat, 
ImageBlockHeaderand Data 
fields. If this is an interframe, 
and this block has not 
changed since the last 
keyframe, DataSize is 0 and 
the Data field is absent. 

Format 

IMAGEFORMAT 

Compression format of block 
data. 
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IMAGEBLOCKV2 



Field 

Type 

Comment 

ImageBlockHeader 

If Format’s HasDiffBlock = 
1, IMAGEDIFFPOSITION 

If Format’s 

ZllbPrImeCompressCurren 
t = 1, 

IMAGEPRIMEPOSITION 

Describes the format and 
compression of Data 

Data 

If DataSIze > 0, 
UI8[DataSlze] 

Pixel data compressed using 
ZLIB. Pixels are ordered 
from bottom left to top right 

In rows. Each pixel Is three 
bytes: B, G, R. 

Image format 



The IMAGEFORMAT byte describes the color depth and compression of the 
IMAGEBLOCKV2 structure. 

IMAGEFORMAT 



Field 

Type 

Comment 

Reserved 

UB[3] 

Must be 0 

ColorDepth 

UB[2] 

00: 24-blt RGB image 

10:15/7-bit hybrid color 

Image 

HasDiffBlocks 

UB[1] 

If 1, the data starts and stops 
on specific rows within the 
block and does not represent 
the entire block. 

ZlibPrimeCompressCurrent 

UB[1] 

If 1, the current data block 
was produced with the ZLIB 
priming technique of 
compression. 

ZlibPrimeCompressPrevious 

UB[1] 

If 1, the previous data block 
was produced with the ZLIB 
priming technique of 
compression. 
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Image block diff position 


The image block diff position can be included 
field. This structure describes the location and 

in the IMAGEBLOCKY2 ImageBlockHeader 
size of the dilfi block image data. 

IMAGEDIFFPOSITION 



Field 

Type 

Comment 

RowStart 

UI8 

Indicates the first scan line of 

the block that contains the 

Image data. 

Height 

UI8 

Indicates the height, In 
contiguous scan lines, of the 
Image data. 


Image block prime position 

The image block prime position is included in the IMAGEBLOCKV2 ImageBlockHeader 
field if the IMAGEFORMAT structure indicates ZLIB priming is used. This structure 
specifies which image is used as the priming source. 


IMAGEPRIMEPOSITION 

Field 

Type 

Comment 

Block column 

ul8 

Indicates the position of the 



source block. 

Block row 

ul8 

Indicates the position of the 



source block. 


On2 Truemotion VP6 bitstream format 

SWF 6 or later supports a new video format, On2 Truemotion VP6, which can be played in 
Flash Player 8 and later. VP6 is a leading-edge video compression algorithm that combines 
traditional motion compensated prediction and pseudo discrete cosine transform (DCT) 
coding and context-dependent entropy-coding techniques (based on Huffman and arithmetic 
principles) along with novel approaches to surpass the quality of other codecs. VP6 applies 
extensive context modeling, in and out of loop filtering, and novel quantization methods to 
achieve a high level of quality. Further information on this video format can be obtained from 
On2: www.on2.com. 
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Like the Sorenson H.263 video format, the On2 Truemotion VP6 video format uses color 
information encoded in the YCbCr color space described in the ITU-R BT.601 standard. 
This color information is stored as YUV 4:2:2 using unsigned 8-bit values for each color 
component. The following algorithm can be used to convert forward from RGB color space 
pixel data to YUV color space: 

FUNCTION SATURATE(A) = MIN(255.MAX(0,A)) 


Y 

= SATURATE(+ 

(0.257 * 

R) + (0.504 

* G) 

+ (0.098 * 

B) 

+ 

16) 

U 

= SATURATE!- 

(0.148 * 

R) - (0.291 

* G) 

+ (0.439 * 

B) 

+ 

128) 

V 

= SATURATE(+ 

(0.439 * 

R) - (0.368 

* G) 

- (0.071 * 

B) 

+ 

128) 


This algorithm can be used to convert YUV color space pixel data back to RGB color space: 

B = SATURATE(1.164(Y - 16) + 2.018(U - 128)) 

G = SATURATE(1.164(Y - 16) - 0.813(V - 128) - 0.391(U - 128)) 

R = SATURATE(1.164(Y - 16) + 1.596(V - 128)) 

In addition to supporting standard On2 Truemotion VP6 video streams, Flash Player 8 adds 
support for an extra alpha channel that is used to simulate transparency. The alpha channel is 
encoded by using a second On2 Truemotion VP6 stream that contains the alpha channel 
information. To encode this type of video stream, the preceding RGB-to-YUV algorithm 
should be used on the RGB color channels of the premultiplied ARGB color space pixel data. 
With the resulting YUV color space data, the video data can be encoded as the first video 
stream. 

For the second video stream, the following algorithm can be used to obtain the YUV video 
data from the alpha channel of the premultiplied ARGB color space pixel data: 

Y = A 
U = 0 

V = 0 

O 
H 

m 


At encode time, the second video stream must contain at least as many key frames as 
the first video stream. Each key frame occurring in the first video stream must force a key 
frame in the second video stream at encode time so that the combined video stream 
stays seekable. 


To decode alpha channel video streams, assume that the first video stream returns YUV- 
encoded color channels for a screen pixel in the form of three channels named Yl, Ul, and 
VI. The second video stream returns this data as Y2, U2, and V2. The resulting alpha 
premultiplied ARGB pixel values are obtained by using the following algorithm: 

B = MIN(Y2.SATURATE(1.164(Y1 - 16) + 2.018(U1 - 128))) 

G = MIN(Y2.SATURATE(1.164(Y1 - 16) - 0.813(V1 - 128) - 0.391(U1 - 128))) 

R = MIN(Y2.SATURATE(1.164(Y1 - 16) + 1.596(V1 - 128))) 

A = Y2 

The U2 and V2 channels are not currently used at decode time. 
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VP6 FLV video packet 

The VP6 FLV video packet represents a VP6 video frame within an FLV file. 


VP6FLVVIDEOPACKET 



Field 

Type 

Comment 

HorizontalAdjustment 

UB[4] 

Number of pixels to subtract 
from the total width. The 
resulting width is used on the 
stage, and the rightmost pixels 
of the video is cropped. 

VerticalAdjustment 

UB[4] 

Number of pixels to subtract 
from the total height. The 
resulting height is used on the 
stage, and the rightmost pixels 
of the video is cropped. 

Data 

UI8[n] 

Raw VP6 video stream data 

VP6 FLV Alpha video packet 


The VP6 FLV Alpha video packet represents a VP6 video frame with alpha channel 
information within FLV files. 

VP6FLVALPHAVIDEOPACKET 


Field 

Type 

Comment 

HorizontalAdjustment 

UB[4] 

Number of pixels to subtract 
from the total width. The 
resulting width is used on the 
stage, and the rightmost pixels 
of the video is cropped. 

VerticalAdjustment 

UB[4] 

Number of pixels to subtract 
from the from the total height. 
The resulting height is used on 
the stage, and the rightmost 
pixels of the video is cropped. 

OffsetToAlpha 

UI24 

Offset in bytes to the alpha 
channel video data 


252 Video 



VP6FLVALPHAVIDEOPACKET 


Field 

Type 

Comment 

Data 

UI8[OffsetToAlpha] 

Raw VP6 video stream data 
representing the color channels 

AlphaData 

UI8[n] 

Raw VP6 video stream data 
representing the aipha channel 


VP6 SWF video packet 

The VP6 SWF video packet represents a VP6 video frame within SWF files. 

VP6SWFVIDEOPACKET 

Field Type Comment 

Data UI8[n] Raw VP6 video stream data 

VP6 SWF Alpha video packet 

The VP6 SWF Alpha video packet represents a VP6 video frame with alpha channel 
information within SWF files. 

VP6SWFALPHAVIDEOPACKET 

Field Type Comment 

OffsetToAlpha UI24 Offset in bytes to the alpha 

channel video data 

Data UI8[OffsetToAlpha] Raw VP6 video stream data 

representing the color channels 

AlphaData UI8[n] Raw VP6 video stream data 

representing the aipha channel 


SWF video tags 

The following tags define embedded video data within a SWF file. These tags are permissible 
only in SWF 6 or later. 

Video embedded in a SWF file is always streamed: video frames are located in the SWF 
frames with which they are temporally associated, and video playback can begin before an 
entire video stream is downloaded. This process is comparable to the way that streaming 
sounds are defined (see Streaming sound). 
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DefineVideoStream 


DefineVideoStream defines 
The Display List). 

a video character that can 

later be placed on the display list (see 

DefineVideoStream 



Field 

Type 

Comment 

Header 

RECORDHEADER 

Tag type = 60 

CharacterlD 

UI16 

ID for this video character 

NumFrames 

UI16 

Number of VideoFrame tags 
that makes up this stream 

Width 

UI16 

Width in pixels 

Height 

UI16 

Height in pixels 

VideoFlagsReserved 

UB[4] 

Must be 0 

VideoFlagsDeblocking 

UB[3] 

000 = use VIDEOPACKET 

value 

001 = off 

010 = Level 1 (Fast deblocking 
filter) 

Oil = Level 2 (VP6 only, better 
deblocking filter) 

100 = Level 3 (VP6 only, better 
deblocking plus fast deringing 
filter) 

101 = Level 4 (VPS only, better 
deblocking plus better 
deringing filter) 

110 = Reserved 

111 = Reserved 

VideoFlagsSmoothing 

UB[1] 

0 = smoothing off (faster) 

1 = smoothing on (higher 
quality) 

CodecID 

UI8 

2 = Sorenson H.263 

3 = Screen video (SWF 7 and 
later only) 

4 = VP6 (SWF 8 and later only) 

5 = VPS video with alpha 
channel (SWF 8 and later only) 
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VideoFrame 


VideoFrame provides a single frame of video data for a video character that is already defined 
with DefineVideoStream. 

In playback, the time sequencing of video frames depends on the SWF frame rate only. When 
SWF playback reaches a particular SWF frame, the video images from any VideoFrame tags in 
that SWF frame are rendered. Any timing mechanisms built into the video payload are 
ignored. 

A VideoFrame tag is not needed for every video character in every frame number specified. A 
VideoFrame tag merely sets video data associated with a particular frame number; it does not 
automatically display a video frame. To display a video frame, specify the frame number as the 
Ratio field in PlaceObject2 or PlaceObject3. 


VideoFrame 

Field 

Type 

Comment 

Header 

RECORDHEADER 

Tag type = 61 

StreamID 

UI16 

ID of video stream character of 
which this frame is a part 

FrameNum 

UI16 

Sequence number of this frame 
within its video stream 

VideoData 

if CodecID = 2 

H263VIDEOPACKET 

if CodecID = 3 

SCREENVIDEOPACKET 
if CodecID = 4 

VP6SWFVIDEOPACKET 

if CodecID = 5 

VP6SWFALPHAVIDEOPACKET 

if CodecID = 6 

SCREENV2VIDEOPACKET 

Video frame payload 
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CHAPTER 17 

FLV File Format 



Starting with SWF 6, Flash Player can exchange audio, video, and data over RTMP 
connections with the Macromedia Flash Communication Server. One way to feed data to 
Flash Communication Server (and thus on to Flash Player clients) is from files in the Flash 
Video (FLV) file format. Starting with SWF 7, Flash Player can also play FLV files directly 
with MIME type video/x-flv. 

An FLV file encodes synchronized audio and video streams. The audio and video data within 
FLV files are encoded in the same way as audio and video within SWF files. 

This document describes FLV version 1. 

Each tag type in an FLV file constitutes a single stream. There can be, at most, one audio and 
one video stream, synchronized together, in an FLV file. You cannot to define multiple 
independent streams of a single type. 


z 

o 

H 

m 


FLV files, unlike SWF files, store multibyte integers in big-endian byte order. This means 
that, for example, the number 300 (0x12C) as a UI16 in SWF file format is represented 
by the byte sequence 0x2C 0x01, while as a UI16 in FLV file format, it is represented by 
the byte sequence 0x01 0x2C. Also note that FLV uses a 3-byte integer type, LII24, that 
is not used in SWF. 
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The FLV Header 

All FLV files begin with the following header: 


FLV File Header 

Field 

Type 

Comment 

Signature 

UI8 

Signature byte always ‘F’ 

(0x46) 

Signature 

UI8 

Signature byte always ‘L’ 

(0x4C) 

Signature 

UI8 

Signature byte always ‘V’ 

(0x56) 

Version 

UI8 

File version (for example, 0x01 
for FLV version 1) 

T ypeFlagsReserved 

UB[5] 

Must be 0 

TypeFlagsAudio 

UB[1] 

Audio tags are present 

T ypeFlagsReserved 

UB[1] 

Must be 0 

TypeFlagsVideo 

UB[1] 

Video tags are present 

DataOffset 

UI32 

Offset in bytes from start of file 
to start of body (that is, size of 
header) 

The DataOffset field usually has a value of 9 for FLV version 1. This field is present in order 
to accommodate larger headers in future versions. 

The FLV File Body 

After the FLV header, the remainder of an FLV file consists 
tags. They interleave as shown in the following table: 

of alternating back-pointers and 

FLV File Body 

Field 

Type 

Comment 

PreviousT agSizeO 

UI32 

Always 0 

Tag1 

FLVTAG 

First tag 
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FLV File Body 

Field 

Type 

Comment 

PreviousT agSizel 

UI32 

Size of previous tag, including 
its header. 

For FLV version 1, this is the 
previous tag’s DataSize plus 11. 

Tag2 

FLVTAG 

Second tag 

PreviousT agSizeN-1 

UI32 

Size of second-to-last tag 

TagN 

FLVTAG 

Last tag 

PreviousT agSizeN 

UI32 

Size of last tag 

FLV Tags 

FLV tags have the following format: 


FLVTAG 

Field 

Type 

Comment 

TagType 

UI8 

Type of this tag. Values are: 

8: audio 

9: video 

18: script data 
all others: reserved 

DataSize 

UI24 

Length of the data in the Data 
field 

Timestamp 

UI24 

Time in milliseconds at which 
the data in this tag applies. This 
is relative to the first tag in the 
FLV file, which always has a 
timestamp of 0. 

TimestampExtended 

UI8 

Extension of the Timestamp 
field to form a UI32 value. This 
field represents the upper 8bits, 
while the previous Timestamp 
field represents the lower 

24bits of the time in 

milliseconds. 
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FLVTAG 

Field Type Comment 

UI24 Always 0 

lfTagType = 8 Body of the tag 

AUDIODATA 
If TagType = 9 
VIDEODATA 
If TagType = 18 
SCRIPTDATAOBJECT 

In playback, the time sequencing of FLV tags depends on the FLV timestamps only. Any 
timing mechanisms built into the payload data format are ignored. 

Audio Tags 

Audio tags are similar to the DefmeSound tag in the SWF file format, and their payload data 
is identical, except for the additional Nellymoser 8kHz format, which is not permitted in 
SWF. 


AUDIODATA 



Field 

Type 

Comment 

SoundFormat 

UB[4] 

0 = uncompressed 

1 = ADPCM 

2 = MP3 

5 = Nellymoser 8kHz mono 

6 = Nellymoser 

Format of SoundData 

SoundRate 

UB[2] 

0 = 5.5 kHz 

1 = 11 kHz 

2 = 22 kHz 

3 = 44 kHz 

Sampling rate 

SoundSIze 

UB[1] 

0 = snd8Blt 

1 = snd16Blt 

Size of each sample 

SoundType 

UB[1] 

0 = sndMono 

1 = sndStereo 

Mono or stereo sound 

For Nellymoser: always 0 

SoundData 

UI8[slze of sound data] 

Sound data-varles by format 


SfreamlD 

Data 
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Nellymoser 8kHz is a special case—the 8kHz sampling rate is not supported in other formats, 
and the SoundRate bits can’t represent this value. When Nellymoser 8kHz mono is specified 
in SoundFormat, the SoundRate and SoundType fields are ignored. For other Nellymoser 
sampling rates, specify the normal Nellymoser SoundFormat and use the SoundRate and 
SoundType fields as usual. 

Video Tags 


Video tags are similar to the VideoFrame tag in SWF, and their payload data is identical. 


VIDEODATA 



Field 

Type 

Comment 

FrameType 

UB[4] 

1: keyframe 

2: inter frame 

3: disposable inter frame 
(H.263 only) 

CodecID 

UB[4] 

2: Sorenson H.263 

3: Screen video 

4:On2VP6 

5: On2 VP6 with alpha channel 
6: Screen video version 2 

VideoData 

If CodecID = 2 
H263VIDEOPACKET 

If CodecID = 3 

SCREENVIDEOPACKET 

If CodecID = 4 

VP6FLVVIDEOPACKET 

If CodecID = 5 

VP6FLVALPHAVIDEOPAC 

KET 

If CodecID = 6 

SCREENV2VIDEOPACKET 

Video frame payload 
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Data Tags 

Data tags encapsulate single-method invocation, which is usually called on a NetStream 
object in the Flash Player. Data tags are formed from a method name and a set of arguments. 

SCRIPTDATAOBJECT and SCRIPTDATAOBJECTEND 

A SCRIPTDATAOBJECT record defines object data in ActionScript. Lists of 
SCRIPTDATAOBJECT records are terminated by using the SCRIPTDATAOBJECTEND 
tag. 


SCRIPTDATAOBJECT 



Field 

Type 

Comment 

ObjectNameT y pe 

UI8 

Always 2 

ObjectName 

SCRIPTDATASTRING 

Name of the object 

ObjectData 

SCRIPTDATAVALUE 

Data of the object 


SCRIPTDATAOBJECTEND 


Field 

Type 

Comment 

ObjectEndMarkerl 

UI8 

Always 2 

ObjectEndMarker2 

UI24 

Always 9 
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SCRIPTDATASTRIN6 and SCRIPTDATAL0N6STRIN6 

The SCRIPTDATASTRING and SCRIPTDATALONGSTRING records are used to define 
strings for data tags. The StringData field must be zero-terminated, and the StringLength field 
must include the zero terminator. 

The SCRIPTDATALONGSTRING record can be used to specify strings larger than 65535 
characters. 


SCRIPTDATASTRING 



Field 

Type 

Comment 

StringLength 

UI16 

String length in bytes 

StringData 

STRING 

String data 


SCRIPTDATALONGSTRING 


Field 

Type 

Comment 

StringLength 

UI32 

String length in bytes 

StringData 

STRING 

String data 

SCRIPTDATAVALUE 


A SCRIPTDATAVALUE record represents an abstract definition of an ActionScript value or 
object. It can contain a list of values, objects, variables or arrays. 

SCRIPTDATAVALUE 



Field 

Type 

Comment 

Type 

UI8 

Type of the variable: 

0 = Number type 

1 = Boolean type 

2 = String type 

3 = Object type 

4 = MovieClip type 

5 = Null type 

6 = Undefined type 

7 = Reference type 

8 = ECMA array type 

10 = Strict array type 

11 = Date type 

12 = Long string type 

ECMAArrayLength 

If Type = 8, UI32 

Number of fields of 

ECMA array 
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SCRIPTDATAVALUE 

Field 

ScriptDataValue 


Comment 

Script data values 


Type 

If Type = 0, DOUBLE 
If Type = 1, UI8 

If Type = 2, SCRIPTDATASTRING 
If Type = 3, 

SCRIPTDATAOBJECT[n] 

If Type = 4, SCRIPTDATASTRING 
defining the MovieClip path 
If Type = 7, UI16 
If Type = 8, 

SCRIPTDATAVARIABLE[ECMAArr 
ayLength] 

If Type = 10, 

SCRIPTDATAVARIABLE[n] 

If Type = 11, SCRIPTDATADATE 
If Type = 12, 

SCRIPTDATALONGSTRING 

ScriptDataValueTerminator If Type = 3, Terminators for Object 

SCRIPTDATAOBJECTEND and Strict array lists 

If Type = 10, 

SCRIPTDATAVARIABLEEND 

SCRIPTDATAVARIABLE and 
SCRIPTDATAVARIABLEEND 

A SCRIPTDATAVARIABLE record defines variable data in ActionScript. Lists of 
SCRIPTDATAVARIABLE records are terminated by using the 
SCRIPTDATAVARIABLEEND tag. 

SCRIPTDATAVARIABLE 

Field Type Comment 

VariableName SCRIPTDATASTRING Name of the variable 

VariableData SCRIPTDATAVALUE Data of the variable 

SCRIPTDATAVARIABLEEND 

Field Type Comment 

VariableEndMarkerl UI24 Always 9 
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SCRIPTDATADATE 

A SCRIPTDATADATE record defines a particular date and time. 


SCRIPTDATADATE 



Field 

Type 

Comment 

DateTime 

UI64 

Number of milliseconds since 
Jan 1,1970 UTC. 

LocalDateTimeOffset 

SI16 

Local time offset in minutes 

from UTC. For time zones 
located west of Greenwich, UK, 
this is a negative number. Time 
zones east of Greenwich, UK, 
are positive. 
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APPENDIX A 


Flash Uncovered: A Sinnple Macronnedia 
Flash (SWF) File Dissected 


A 


To write Macromedia Flash SWF files, you must be able to read and understand the raw bits 
and bytes. This appendix examines a simple, one-frame Flash file that contains only a 
rectangle. 

Here is a hex dump of the SWF file: 


000000 

46 

57 

53 

03 

4F 

00 

00 

00 

78 

00 

05 

5F 

00 

00 

OF 

AO 

000010 

00 

00 

OC 

01 

00 

43 

02 

FF 

FF 

FF 

BF 

00 

23 

00 

00 

00 

000020 

01 

00 

70 

FB 

49 

97 

OD 

OC 

7D 

50 

00 

01 

14 

00 

00 

00 

000030 

00 

01 

25 

C9 

92 

OD 

21 

ED 

48 

87 

65 

30 

3B 

6D 

El 

D8 

000040 

B4 

00 

00 

86 

06 

06 

01 

00 

01 

00 

00 

40 

00 

00 

00 



A SWF file always begins with a header. It describes the file version, the length of the file in 
bytes, the frame size in twips (twentieths of a pixel), frame rate in frames per second, and the 
frame count. 


SWF File Header 


Field 

Type* 

Comment 

Signature 

UI8 

Signature byte: 

“F” indicated uncompressed 

“C” indicates compressed (SWF 6 or later only) 

Signature 

UI8 

Signature byte always “W” 

Signature 

UI8 

Signature byte always “S” 

Version 

UI8 

Single byte file version (for example, 0x06 for SWF 6) 

FileLength 

UI32 

Length of entire file in bytes 

FrameSize 

RECT 

Frame size in twips 

FrameRate 

UI16 

Frame delay in 8.8 fixed number of frames per second 

FrameCount 

UI16 

Total number of frames in file 


* The types are defined in Basic Data Types. 
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The first three bytes are the standard signature for all SWF files. They are the ASCII values of 
the characters ‘F’ (or ‘C’), ‘W’, and ‘S’ in that order. The fourth byte indicates the version of 
the file. 

0x46-»‘F’ 0x57 ^‘W’ 0x53-»‘S’ 0x03-» 3 

The next four bytes represent an unsigned 32-bit integer indicating the file size. Here’s where 
it starts getting tricky and machine architecture gets involved. The next four bytes are 
Ox4FOOOOOO so that would imply that the file length is 1325400064 bytes, a very large 
number which doesn’t make sense. What we failed to do is swap all the bytes. 

In SWF files, bytes are swapped whenever reading words and dwords such that a 32-bit value 
B1B2B3B4 is written as B4B3B2B1, and a 16-bit value B1B2 is written as B2B1. Single bytes 
are written unchanged since there is no bit-swapping. The reason for this is the differences in 
storage and retrieval between the Mac and PC processors. 

Reversing the bytes we can read the four bytes correctly and see that file is 79 bytes long. 
0X4FOOOOOO -» 0x0000004F 79 

The next nine bytes represent a data structure used in the SWF format called a Rectangle. 
Here is the file description of a rectangle: 


RECT 

Field Type Comment 


Nbits 

UB[5] 

Bits in each rect value field 

Xmin 

SB[Nbits] 

X minimum position for rect 

Xmax 

SB[Nbits] 

X maximum position for rect 

Ymin 

SB[Nbits] 

y minimum position for rect 

Ymax 

SB[Nbits] 

y maximum position for rect 

To understand these bytes. 

we need to look 

at the individual bits. 


78 00 05 5F 00 00 OF AO 00 


0111 1000 0000 0000 0000 0101 0101 nil oooo oooo 
0000 oooo oooo nil loio oooo oooo oooo 

There are five fields in a rectangle structure: Nbits, Xmin, Xmax, Ymin, Ymax. The unsigned 
Mbits field occupies the first five bits of the rectangle and indicates how long the next four 
signed fields are. 
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Another subtle point about the SWF file representation is that reading and writing bits is 
different from reading and writing words and dwords. When reading and writing bits, no 
byte-swapping occurs. This is because when Flash is reading an «-bit field, it reads a byte at a 
time until it has read all n bits. Therefore, the next five bits are read in order and evaluate to 

15. 

01111 -» 15 

What if Nbit has a value of sixteen? This is exactly the size of a word so do we read the 
following fields as words and swap bytes? No. Fields described by bit size are always read a 
byte at a time. No swapping, just read the next n bits in that order. 

000000000000000 < 0 = Xmin 

010101011111000 < 11000 = Xmax 

000000000000000 < 0 = Ymin 

001111101000000 < 8000 = Ymax 

For the header, the rectangle is used to store the file dimensions with Xmax corresponding to 
the file width and Ymax corresponding to the file height, both in twips. In SWF format, a 
twip is a twentieth of a pixel, so if we convert to pixels, we see that our file is 550 x 400. 

Now we have looked at all of the fields of the rectangle and evaluated them, but what about 
those last seven bits which are all Os. Well, they were just “filled.” 

0000000 = filled bits 

After the end of any structure, if the structure does not completely fill up its last byte, then 
that last byte is filled with Os to keep the next item byte aligned. So if the next item is a word 
or dword, you can read it as such and not worry about being in the middle of a byte. In this 
case, only one bit in the last byte is used so the last seven bits are filled with Os. 

Next in the header is the frame rate. It is supposed to be stored as a 16-bit integer, but the first 
byte (or last depending on how you look at it) is completely ignored. So the frame rate is 
12 fps. 

OxOOOC -» OxOCOO -» OxOC -» 12 = frame rate 

Next is the frame count, which is also a 16-bit integer. So the frame count is 1. 

0x0100 -» 0x0001(byte swapping) -» 1 = frame count 
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Now we are finished with the header. After the header is a series of tagged data blocks. Here is 
a description of a tag (this is simplifying somewhat; byte swapping is necessary): 

RECORDHEADER (short) 

Field Type Comment 

TagCodeAndLength UI16 Upper 10 bits: tag type 

Lower 6 bits: tag length 


RECORDHEADER (long) 

Field Type Comment 


TagCodeAndLength 

UI16 

Tag type and length of Ox3F 
Packed together as in short header 

Length 

UI32 

Length of tag 


There are two types of tags: the short and long tag header. Regardless of which case you have, 
you begin by looking at the first word. 

0x4302-» 0x0243-» 0000 0010 0100 0011 

The first 10 bits of the tag are the unsigned tag type. The tag type indicates what type of data 
is to follow in the body of the data block to follow. In this case, the value of the tag type is 9, 
which corresponds to a SetBackgroundColor block. The last six unsigned bits of the tag 
header indicate the length of the data block to follow if it is 62 bytes or less. If the length of 
the data block is more than 62 bytes, then this field has all Is and the length is indicated in 
the following dword. For the tag we are looking at, the field does not have all Is, so it does 
indicate the actual length which is 3 bytes. 

0000001001 = 9 = SetBackgroundColorOOOOll = 3 = body length 

Since we know that the length of the body is 3 bytes, let’s take a look at it. A 
SetBackgroundColor tag only contains the 3-byte RGB color description so we evaluate it as 
such. A color is its own 3-byte data type so there is no byte swapping. 

OXFFFFFF = white 
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The next tag is a long tag and is a DefmeShape tag. 

OxBFOO OxOOBF 0000 0000 1011 1111 

0000000010 = 2 = DefineShape 

mill = 63 = body length (indicates that the body length value is in the next dword) 


0x23000000 

0x00000023 

35 = body length 

Here is the file description of DefineShape: 


DefineShape 



Field 

Type 

Comment 

Header 

RECORDHEADER 

Tag type = 2 

Shapeld 

UI16 

ID for this character 

ShapeBounds 

RECT 

Bounds of the shape 

Shapes 

SHAPEWITHSTYLE 

Shape information 


The body of a DefmeShape is composed of an unsigned 16-bit character ID, a rectangle 
defining the bounds for the shape, and a SHAPEWITHSTYLE structure which contains 
shape information. 


0x0100 0x0001 -» 1 = shape ID 

Now the Rect which defines the boundaries: 

70 FB 49 97 OD OC 7D 50 




0111 0000 nil 1011 0100 
1100 0111 1101 0101 0000 
OHIO = 14 = Nbits 

1001 1001 0111 0000 1101 

0000 

00011111011010 = 2010 = Xmin 

/20 to covert to pixels from twips 

100.5 

01001100101110 = 4910 = Xmax 


245.5 

00011010000110 = 1670 = Ymin 


83.5 

00111110101010 = 4010 = Ymax 


200.5 

000 = fill bits 
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The following table describes the SHAPEWITHSTYLE structure: 


SHAPEWITHSTYLE 



Field 

Type 

Comment 

FillStyles 

FILLSTYLEARRAY 

Array of fill styles 

LineStyles 

LINESTYLEARRAY 

Array of line styles 

NumFillBits 

UB[4] 

Number of fill index bits 

NumLineBits 

UB[4] 

Number of line index bits 

ShapeRecords 

SHAPERECORD[oneor 

more] 

Shape records (see following) 


A fill style array itself has three fields. The first field is an 8-bit integer count which indicates 
how many fill styles are in the array. This count works similar to the tag’s length field in that if 
it is all Is, you have to look at the next 16 bits to get the actual length. Elere is the file 
description: 

FILLSTYLEARRAY 


Field 

Type 

Comment 

FillStyleCount 

UI8 

Count of fill styles 

FillStyleCountExtended 

If FillStyleCount = OxFF UI16 

Extended count of fill styles. 
Supported only for Shape2 and 
Shapes. 

FillStyles 

FILLSTYLE[FillStyleCount] 

Array of fill styles 


In this case, the 8-bit count is equal to 0 so there is nothing to follow it. 

0x00 = 0 = Fi 11 Sty 1 eCount -» This is the end of the fill style array because it has no 
elements 

A line style array is exactly the same as a fill style array except it stores line styles. Here is the 
file description: 


LINESTYLEARRAY 


Field 

Type 

Comment 

LineStyleCount 

UI8 

Count of line styles 

LineStyleCountExtended 

If LineStyleCount = OxFF 

Extended count of line styles 


UI16 


LineStyles 

LINESTYLE[count] 

Array of line styles 
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0x01 = 1 = Li neSty 1 eCount -» So there is one line style in the array. 

A line style has two parts, an unsigned 16-bit integer indicating the width of a line in twips, 
and a color. Here is the file description: 


LINESTYLE 



Field 

Type 

Comment 

Width 

UI16 

Width of line in twips 

Color 

RGB (Shapel or Shape2) 

Color value including alpha 


RGBA (Shapes) 

channel information forShapeS 


The color in this case is a 24-bit RGB, but if we were doing a DefmeShaped, it would be a 32- 
bit RGBA where alpha is the transparency of the color. 

0x1400 -* 0x0014 = 20 = width = 1 pixel 
0x000000 = RGB = black 

Back to the ShapeWithStyle, the NumFillBits field is 4 bits, as is the NumLineBits. 

0x0 = 0 = NumFillBits 0x1 = 1 = NumLineBits 
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Now for the array of shape records. The following four tables describe the four types of shape 
records. Here are the file descriptions: 


ENDSHAPERECORD 



Field 

Type 

Comment 

TypeFlag 

UB[1] 

Non-edge record flag 

Always 0 

EndOfShape 

UB[5] 

End of shape flag 

Always 0 


STYLECHANGERECORD 


Field 

Type 

Comment 

TypeFlag 

UB[1] 

Non-edge record flag 

Always 0 

StateNewStyles 

UB[1] 

New styles flag. Used by 
DefineShape2 and 
DefineShapeS only. 

StateLineStyle 

UB[1] 

Line style change flag 

StateFillStylel 

UB[1] 

Fill style 1 change flag 

StateFillStyleO 

UB[1] 

Fill style 0 change flag 

StateMoveTo 

UB[1] 

Move to flag 

Move Bits 

If StateMoveTo 

UB[5] 

Move bit count 

MoveDeltaX 

If StateMoveTo 
SB[MoveBits] 

Delta X value 

MoveDeltaY 

If StateMoveTo 
SB[MoveBits] 

Delta Y value 

FillStyleO 

If StateFillStyleO 
UB[FillBits] 

Fill 0 Style 

FillStylel 

If StateFillStylel 
UB[FillBits] 

Fill 1 Style 

LineStyle 

If StateLineStyle 
UB[LineBits] 

Line Style 

FillStyles 

If StateNewStyles 
FILLSTYLEARRAY 

Array of new fill styles 
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STYLECHANGERECORD 


Field 

Type 

Comment 

LineStyles 

If StateNewStyles 
LINESTYLEARRAY 

Array of new line styles 

NumFillBits 

If StateNewStyles 

UB[4] 

Number of fill index bits for new 
styles 

NumLineBits 

If StateNewStyles 

UB[4] 

Number of line Index bits for 
new styles 
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STRAIGHTEDGERECORD 



Field 

Type 

Comment 

TypeFlag 

UB[1] 

This is an edge record. 

Always 1. 

StraightFlag 

UB[1] 

Straight edge. 

Always 1. 

NumBits 

UB[4] 

Number of bits per value 
(two less than the actual 
number). 

GeneralLineFlag 

UB[1] 

General Line equals 1. 

Vert/Horz Line equals 0. 

DeltaX 

If GeneralLineFlag 
SB[NumBits+2] 

X delta 

DeltaY 

If GeneralLineFlag 
SB[NumBits+2] 

Y delta 

VertLineFlag 

If GeneralLineFlag 
SB[1] 

Vertical Line equals 1. 

Horizontal Line equals 0. 

DeltaX 

If VertLineFlag 
SB[NumBits+2] 

X delta 

DeltaY 

If VertLineFlag 
SB[NumBits+2] 

Y delta 


CURVEDEDGERECORD 



Field 

Type 

Comment 

TypeFlag 

UB[1] 

This is an edge record. 

Always 1. 

StraightFlag 

UB[1] 

Curved edge. 

Always 0. 

NumBits 

UB[4] 

Number of bits per value. 

(two less than the actual 
number) 

ControlDeltaX 

SB[NumBits+2] 

X control point change 

ControlDeltaY 

SB[NumBits+2] 

Y control point change 

AnchorDeltaX 

SB[NumBits+2] 

X anchor point change 

AnchorDeltaY 

SB[NumBits+2] 

Y anchor point change 
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ENDSHAPERECORD defines the end of the shape record array. 

STYLECHANGERECORD defines changes in line style, fill style, position, or a new set of 
styles. STRAIGHTEDGERECORD and CURVEDEDGERECORD define a straight or 
curved edge, respectively. The first bit in a shape record is a type flag. A 0 corresponds to a 
non-edge record, and a 1 corresponds to an edge record. Looking at the first bit of our first 
shape record, we see that it is not an edge record. Now we must look at the next five bits 
which are all flags that tell us what is to follow. If all of the five bits are 0, then that is a typeO 
shape record and defines the end of the array of shape records. 

25 C9 92 OD 21 

0010 0101 1100 1001 1001 0010 0000 1101 0010 0001 
0 = 0 = non edge record 

01001 = 5 flags line style flag is true, and move to flag is true 

Since the move to flag is true, the next five bits are the MoveBits field. This value is 14 so the 
next two fields which are the MoveDeltaX, and the MoveDeltaY are of size 14. These are 
unsigned numbers. 

OHIO = MoveBits 

01001100100100 = 4900 (twips) = 245 pixels = MoveDeltaX 
00011010010000 = 1680 = 84 pixels = MoveDeltaY 

Since the line style flag is true, the next field is a NumLineBits = 1 bit field representing the 
line style. This field is equal to 1. This means that the line style for the line to follow is the 
first one in the line style array. 

1 = 1= line style 

Now for the rest of the shape records: 

ED 48 87 65 30 3B 6D El D8 B4 00 00 

1110 1101 0100 1000 1000 0111 0110 0101 
1101 1110 0001 1101 1000 1011 0100 0000 

The next shape record begins with a 1, so it is an 


0011 0000 0011 1011 0110 
0000 0000 0000 

edge record. 
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The next bit indicates if it is a straight or curved edge. It is a 1, which stands for a straight 
edge. The next four bits indicate the size of any delta fields which follow. The formula for the 
NumBits value is 2 + whatever the value of that 4-bit field. In this case, the value of NumBits 
is 13. Following the NumBits field is a 1-bit line flag. This indicates whether the line being 
described is a general line or horizontal/vertical line. The value of 0 corresponds to a hor/vert 
line, so the next bit is a VertLineFlag field and indicates whether the line is horizontal or 
vertical. The value of the bit is 1 which corresponds to a vertical line. The next field for a 
vertical line is the signed DeltaY field which is nbits =13 bits long. The value corresponds to 
116 pixels. That is the end of the shape record. 

1 = 1= edge record 

1 = 1= straight edge 

1011 = 11 + 2 = 13 = NumBits 

0 = 0 = hor/vert line 

1 = 1= vertical line 

0100100010000 = 2320 twips =116 pixels = DeltaY 
The next three records are very similar to the last one: 

1 = 1= edge record 

1 = 1= straight edge 

1011 = 11 + 2= 13 = NumBits 

0 = 0 = hor/vert line 

0 = 0 = horizontal line 

1010011000000 = -2880 twips (2’s complement number) = -144 pixels = DeltaX 

1 = 1= edge record 

1 = 1= straight edge 

1011 = 11 + 2 = 13 = NumBits 

0 = 0 = hor/vert line 

1 = 1= vertical line 

1011011110000 = -2320 twips = -116 pixels = DeltaY 

1 = 1= edge record 

1 = 1= straight edge 

1011 = 11 + 2 = 13 = NumBits 

0 = 0 = hor/vert line 

0 = 0 = horizontal line 

0101101000000 = 2880 twips = 144 pixels = DeltaX 
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Finally, the last shape record begins with a 0 which means it is not an edge record. 
Furthermore, all of its flag bits are equal to 0, which means that it is the last shape record and 
we are through with our shape record array. 

0 = 0 = non-edge record 

000000 = flags (since they are all 0, this is the end of the shape record array 

Since we are done with our structure, we must now fill our last byte with Os to keep byte 

aligned. 

000000 = filled Os 

We are also done with our shape with style since the shape record array is the last element of 
the shape with style. Since we are already byte aligned, we can go on to our next tagged data 
block. 

The Tag type of the block is equal to 26 which corresponds to a PlaceObject2. The length 
field has a value of 6 so the length of the data block is 6 bytes. 

0x8606-» 0x0686^ 0000 0110 looo oiio 

0000011010 = 26 = tag type = PlaceObject2 
000110 = 6 = length 
06 01 00 01 00 00 

J1 

0000 0110 0000 0001 0000 0000 0000 0001 0000 0000 0000 0000 


Here is the file description of the PlaceObject2 tag: 


PlaceObject2 



Field 

Type 

Comment 

Header 

RECORDHEADER 

Tag type = 26. 

PlaceFlagHasClipActions 

UB[1] 

SWF 5 or later: has clip 
actions (sprite characters 
only). 

Otherwise: always 0. 

PlaceFlagHasClipDepth 

UB[1] 

Has clip depth. 

PlaceFlagHasName 

UB[1] 

Has name. 

PlaceFlagHasRatio 

UB[1] 

Has ratio. 

PlaceFlagHasColorT ransform 

UB[1] 

Has color transform. 

PlaceFlagHasMatrix 

UB[1] 

Has matrix. 
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PlaceObject2 



Field 

Type 

Comment 

PlaceFlagHasCharacter 

UB[1] 

Places a character. 

PlaceFlagMove 

UB[1] 

Defines a character to be 

moved. 

Depth 

UI16 

Depth of character. 

Characterld 

If PlaceFlagHasCharacter 

UI16 

ID of character to place. 

Matrix 

If PlaceFlagHasMatrix 

MATRIX 

Transform matrix data. 

ColorTransform 

If 

PlaceFlagHasColorT ransform 
CXFORMWITHALPHA 

Color transform data. 

Ratio 

If PlaceFlagHasRatIo UI16 


Name 

If PlaceFlagHasName STRING 

Name of character. 

ClipDepth 

If PlaceFlagHasCIlpDepth UI16 

Clip depth 

(see Clipping layers). 

ClipActions 

If PlaceFlagHasCllpActlons 
CLIPACTIONS 

SWF 5 or later: 

Clip Actions Data. 

The first eight bits of the body are all flags indicating what is to follow. A 7 in the sixth bit 
indicates that the body has a transform matrix, and the 1 in the seventh bit indicates that the 
object to be placed has a character ID. 

00000110 -» body has a transform matrix and object has a character ID 

Following the flags is a 16-bit unsigned integer which indicates the depth of the character. In 
this case, the depth is 1, which makes sense since the rectangle is the only object in the file. 

0x0100 -» 

0x0001 -* 

depth = 1 

Since the object has a character ID, the next field in the body is the unsigned 16-bit ID. Since 
the rectangle is the only object in the file, the ID of the rectangle is 1. 

0x0100 -» 

0x0001 -* 

character ID = 1 
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The final field for this PlaceObject2 is the transform matrix. Here is the file description: 


MATRIX 



Field 

Type 

Comment 

HasScale 

UB[1] 

Has scale values If equal to 1. 

NScaleBits 

If HasScale = 1, UB[5] 

Bits in each scale value field. 

SealeX 

If HasScale = 1, FB[NScaleBlts] 

X scale value. 

SealeY 

If HasScale = 1, FB[NScaleBlts] 

y scale value. 

HasRotate 

UB[1] 

Has rotate and skew values If equal 
to 1. 

NRotateBits 

If HasRotate = 1,UB[5] 

Bits In each rotate value field. 

RotateSkewO 

If HasRotate = 1, FB[NRotateBlts] 

First rotate and skew value. 

RotateSkewl 

If HasRotate = 1, FB[NRotateBlts] Second rotate and skew value. 

NTranslateBits 

UB[5] 

Bits In each translate value field. 

T ranslateX 

SB[NT ranslateBIts] 

X translate value In twips. 

T ranslateY 

SB[NT ranslateBIts] 

y translate value In twips. 


Since this shape has no transform information, the matrix is empty. All of its flag bits have 
values of zero. This is not super efficient but it is valid. 

0 x 00 -» completely empty matrix with leftover bits filled 

Since we are done with our PlaceObject2, let’s take a look at our next tag. 

0x4000-» 0x0040-» 0000 0000 0100 0000 

Tag type = 1 = ShowFrame 
length = 0 

We see that the tag is an instruction to show the frame. A ShowFrame has no body. Its length 
is 0, so we move on to the next tag. 

0x0000 0x0000 0000 0000 0000 0000 

Tag type = 0 = end 
length = 0 

We have reached the end tag which signals the end of our SWF file. 
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